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M4(l) 


NAME 

m4 - macro processor 

SYNOPSIS 

m4 [ options ] [ files ] 

HP-UX COMPATIBILITY 

Level: HP-UX/DEVELOPMENT 

Origin: System V 

DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each of the 
argument files is processed in order; if there are no files, or if a file name is the standard input is 
read. The processed text is written on the standard output. 

The options and their effects are as follows: 

-e Operate interactively. Interrupts are ignored and the output is unbuffered. Using this 
mode requires a special state of mind. 

-s Enable line sync output for the C preprocessor (#line ...) 

Change the size of the push-back and argument collection buffers from the default of 
4,096. 

Change the size of the symbol table hash array from the default of 199. The size should 
be prime. 

-Sm^ Change the size of the call stack from the default of 100 slots. Macros take three slots, 
and non-macro arguments take one. 

-Tint Change the size of the token buffer from the default of 512 bytes. 

To be effective, these flags must appear before any file names and before any -D or -U flags: 
-'Dname[=val\ 

Defines name to val or to null in vaPs absence. 

-JJname 

undefines name. 

Macro calls have the form: 

name(argl,arg2, ..., argn) 

The ( must immediately follow the name of the macro. If the name of a defined macro is not fol¬ 
lowed by a (, it is deemed to be a call of that macro with no arguments. Potential macro names 
consist of alphabetic letters, digits, and underscore _, where the first character is not a digit. 

Leading unquoted blanks, tabs, and new-lines are ignored while collecting arguments. Left and 
right single quotes are used to quote strings. The value of a quoted string is the string stripped of 
the quotes. 

When a macro name is recognized, its arguments are collected by searching for a matching right 
parenthesis. If fewer arguments are supplied than are in the macro definition, the trailing argu ¬ 
ments are taken to be null. Macro evaluation proceeds normally during the collection of the argu¬ 
ments, and any commas or right parentheses which happen to turn up within the value of a 
nested call are as effective as those in the original input text. After argument collection, the value 
of the macro is pushed back onto the input stream and rescanned. 

M4 makes available the following built-in macros. They may be redefined, but once this is done 
the original meaning is lost. Their values are null unless otherwise stated. 

define the second argument is installed as the value of the macro whose name is the first 

argument. Each occurrence of $n in the replacement text, where n is a digit, is 
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undefme 

defn 

pushdef 

popdef 

ifdef 

shift 

changequote 

changecom 


divert 

undivert 

divnum 

dnl 

ifelse 

incr 

deer 

eval 
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replaced by the n-th argument. Argument 0 is the name of the macro; missing 
arguments are replaced by the null string; $# is replaced by the number of argu¬ 
ments; $* is replaced by a list of all the arguments separated by commas; is like 
$*, but each argument is quoted (with the current quotes). All $ metavariable 
replacement ignores quoting; every occurrence of a $ metavariable is replaced. 

removes the definition of the macro named in its argument. 

returns the quoted definition of its argument(s). It is useful for renaming macros, 
especially built-ins. 

like define, but saves any previous definition. 

removes current definition of its argument(s), exposing the previous one if any. 

if the first argument is defined, the value is the second argument, otherwise the 
third. If there is no third argument, the value is null. The word Unix is predefined 
on the HP-UX System versions of m4 . 

returns all but its first argument. The other arguments are quoted and pushed back 
with commas in between. The quoting nullifies the effect of the extra scan that will 
subsequently be performed. 

change quote symbols to the first and second arguments. The symbols may be up to 
five characters long. Changequote without arguments restores the original values 
(i.e., ' ')• 

change left and right comment markers from the default # and new-line. With no 
arguments, the comment mechanism is effectively disabled. With one argument, the 
left marker becomes the argument and the right marker becomes new-line. With 
two arguments, both markers are affected. Comment markers may be up to five 
characters long. 

m4 maintains 10 output streams, numbered 0-9. The final output is the concatena¬ 
tion of the streams in numerical order; initially stream 0 is the current stream. The 
divert macro changes the current output stream to its (digit-string) argument. 
Output diverted to a stream other than 0 through 9 is discarded. 

causes immediate output of text from diversions named as arguments, or all diver¬ 
sions if no argument. Text may be undiverted into another diversion. Undiverting 
discards the diverted text. 

returns the value of the current output stream. 

reads and discards characters up to and including the next new-line. 

has three or more arguments. If the first argument is the same string as the second, 
then the value is the third argument. If not, and if there are more than four argu¬ 
ments, the process is repeated with arguments 4, 5, 6 and 7. Otherwise, the value is 
either the fourth string, or, if it is not present, null. 

returns the value of its argument incremented by 1. The value of the argument is 
calculated by interpreting an initial digit-string as a decimal number. Overflow is 
not detected. 

returns the value of its argument decremented by 1. Underflow is not detected. 

evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Opera¬ 
tors include +, -, *, /, %, ** (exponentiation), bitwise j, ", and ~; relational; 
parentheses. Octal and hex numbers may be specified as in C. The second argu¬ 
ment specifies the radix for the result; the default is 10. The third argument may be 
used to specify the minimum number of digits in the result. Overflow and underflow 
are not detected. 
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len 

index 


substr 


translit 

include 

sinclude 

syscmd 

sysval 

maketemp 

mdexit 

m4wrap 

errprint 

dumpdef 

traceon 

traceoff 

SEE ALSO 

mktemp(3). 


returns the number of characters in its argument. 

returns the position in its first argument where the second argument begins (zero 
origin), or -1 if the second argument does not occur. A null (or missing) second 
argument causes index to return 0. 

returns a substring of its first argument. The second argument is a zero origin 
number selecting the first character; the third argument indicates the length of the 
substring. A missing third argument is taken to be large enough to extend to the 
end of the first string. 

transliterates the characters in its first argument from the set given by the second 
argument to the set given by the third. No abbreviations are permitted. 

returns the contents of the file named in the argument. 

is identical to include^ except that it says nothing if the file is inaccessible. 

executes the HP-UX System command given in the first argument. No value is 
returned. 

is the return code from the last call to syscmd. 

calls mktemp(3) to fill in a string of XXXXX in its argument with the current pro¬ 
cess ID. 

causes immediate exit from m4. Argument 1, if given, is the exit code; the default is 

0 . 

argument 1 will be pushed back at final EOF; example: m4wrap(' cleanup() ') 
prints its argument to stderr. 

prints current names and definitions, for the named items, or for all if no arguments 
are given. Output goes to stderr. 

with no arguments, turns on tracing for all macros (including built-ins). Otherwise, 
turns on tracing for named macros. 

turns off trace globally and for any macros specified. Macros specifically traced by 
traceon can be untraced only by specific calls to traceoff. 
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NAME 

hp9000s200, hp9000s500, pdpll, u3b, u3b5, vax - provide truth value about your processor type 

SYNOPSIS 

hp9000s200 

hp9000s500 

pdpll 

u3b 

u3b5 

vax 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

The following commands will return a true value (exit code of 0) if you are on a processor that 
the command name indicates. 

hp9000s200 

True if you are on a Hewlett-Packard 9000 Series 200. 

hp9000s500 

True if you are on a Hewlett-Packard 9000 Series 500. 
pdpll True if you are on a PDP-11/45 or PDP-11/70. 

u3b True if you are on a 3B 20S computer. 

u3b5 True if you are on a 3B 5 computer, 

vax True if you are on a VAX-11/750 or VAX-11/780. 

The commands that do not apply will return a false (non-zero) value. These commands are often 
used within make{l) makefiles and shell procedures to increase portability. 

SEE ALSO 

make(l), sh(l), test(l), true(l). 
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NAME 

mail, rmail - send mail to users or read mail 

SYNOPSIS 

mail [ -epqr ] [ -f file ] 
mail [ >t ] persons 
rmail [ -t ] persons 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

Native Language Support: 

8-bit and 16-bit data. 


DESCRIPTION 

Note: An enhanced user mail interface is presented in mailx(l). 

Mail without arguments prints a user’s mail, message-by-message, in last-in, first-out order. For 
each message, the user is prompted with a ?, and a line is read from the standard input to deter¬ 
mine the disposition of the message: 


<new-line> 

+ 

d 

P 

s [ files ] 
w [ files ] 
m [ persons ] 

q 

EOT (control-d) 

X 

I command 

* 


Go on to next message. 

Same as <new-line>. 

Delete message and go on to next message. 

Print message again. 

Go back to previous message. 

Save message in the named files (mbox is default). 

Save message, without its header, in the named files (mbox is default). 
Mail the message to the named persons (yourself is default). 

Put undeleted mail back in the mailfile and stop. 

Same as q. 

Put all mail back in the mailfile unchanged and stop. 

Escape to the shell to do command. 

Print a command summary. 


The optional arguments alter the printing of the mail: 


-e causes mail not to be printed. An exit value is returned: 

0 = mail present 

1 = no mail 

2 = other error 

-p causes all mail to be printed without prompting for disposition. 

-q causes mail to terminate after interrupts. Normally an interrupt only causes the termina¬ 
tion of the printing of the current message. 

-r causes messages to be printed in first-in, first-out order. 

-ifile causes mail to use file (e.g., mbox) instead of the default mailfile. 

When persons are named, mail takes the standard input up to an end-of-file (or up to a line con¬ 
sisting of just a .) and adds it to each person's mailfile. The message is preceded by the sender’s 
name and a postmark. Lines that look like postmarks in the message, (i.e., “From ...”) are pre¬ 
ceded with a >. The -t option causes the message to be preceded by all persons the mail is sent 
to. A person is usually a user name recognized by login{l). If a person being sent mail is not 
recognized, or if mail is interrupted during input, the file dead.letter will be saved to allow edit¬ 
ing and resending. Note that this is regarded as a temporary file in that it is recreated every time 
needed, erasing the previous contents of dead.letter. 


To denote a recipient on a remote system, prefix person by the system name and exclamation 
mark (see uucp{1C)). Everything after the first exclamation mark in persons is interpreted by 
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the remote system. In particular, if persons contains additional exclamation marks, it can denote 
a sequence of machines through which the message is to be sent on the way to its ultimate desti¬ 
nation. For example, specifying albicde as a recipient’s name causes the message to be sent to 
user b!cde on system a. System a will interpret that destination as a request to send the mes¬ 
sage to user cde on system b. This might be useful, for instance, if the sending system can access 
system a but not system b, and system a has access to system b. Mail will not use uucp if the 
remote system is the local system name (i.e., localsystemluser). 

The mailfile may be manipulated in two ways to alter the function of mail. The other permis¬ 
sions of the file may be read-write, read-only, or neither read nor write to allow different levels of 
privacy. If changed to other than the default, the file will be preserved even when empty to per¬ 
petuate the desired permissions. The file may also contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded to person. This is 
especially useful to forward all of a person’s mail to one machine in a multiple machine environ¬ 
ment. In order for forwarding to work properly the mailfile should have "mail" as group ID, and 
the group permission should be read-write. 

Rmail only permits the sending of mail; uucp{lG) uses rmail as a security precaution. 

When a user logs in, the presence of mail, if any, is indicated. Also, notification is made if new 
mail arrives while using mail. 


FILES 

/etc/passwd 

/usr/mail /user 

$HOME/mbox 

$MAIL 

/tmp/ma* 

/usr/mail/*.lock 

dead.letter 


to identify sender and locate persons 
incoming mail for wser; i.e., the mailfile 
saved mail 

variable containing path name of mailfile 
temporary file 
lock for mail directory 
unmailable text 


SEE ALSO 

login(l), mailx(l), uucp(lC), write(l). 

BUGS 

Conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be forced by typing a p. 
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NAME 

mailx - interactive message processing system 

SYNOPSIS 

mailx [options] [name...] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin; UCB 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

The command mailx provides a comfortable, flexible environment for sending and receiving mes 
sages electronically. When reading mail, mailx provides commands to facilitate saving, deleting, 
and responding to messages. When sending mail, mailx allows editing, reviewing and other 
modification of the message as it is entered. 

Incoming mail is stored in a standard file for each user, called the system mailbox for that user. 
When mailx is called to read messages, the mailbox is the default place to find them. As messages 
are read, they are marked to be moved to a secondary file for storage, unless specific action is 
taken, so that the messages need not be seen again. This secondary file is called the mbox and is 
normally located in the user’s HOME directory (see "MBOX" (ENVIRONMENT VARIABLES) for a 
description of this file). Messages remain in this file until forcibly removed. 

On the command line, options start with a dash (-) and any other arguments are taken to be des¬ 
tinations (recipients). If no recipients are specified, mailx will attempt to read messages from the 
mailbox. Command line options are; 


-d 


-f [filename] 

-F 

-h number 

-H 

-n 

-N 

-r address 

-s subject 
-u user 

-U 


Turn on debugging output. Neither particularly interesting nor recom¬ 
mended. 

Test for presence of mail. Mailx prints nothing and exits with a success 
fill return code if there is mail to read. 

Read messages from filename instead of mailbox. If no filename is 
specified, the mbox is used. 

Record the message in a file named after the first recipient. Overrides the 
"record" variable, if set (see ENVIRONMENT VARIABLES). 

The number of network "hops" made so far. This is provided for network 
software to avoid infinite delivery loops. 

Print header summary only. 

Ignore interrupts. See also "ignore" (ENVIRONMENT VARIABLES). 

Do not initialize from the system default Mailx.rc file. 

Do not print initial header summary. 

Pass address to network delivery software. All tilde commands are dis 
abled. 

Set the Subject header field to subject. 

Read user^s mailbox. This is only effective if user’s mailbox is not read 
protected. 

Convert uucp style addresses to internet standards. Overrides the "conv" 
environment variable. 


When reading mail, mailx is in command mode. A header summary of the first several messages 
is displayed, followed by a prompt indicating mailx can accept regular commands (see COM¬ 
MANDS below). When sending mail, mailx is in input mode. If no subject is specified on the 
command line, a prompt for the subject is printed. As the message is typed, mailx will read the 
message and store it in a temporary file. Commands may be entered by beginning a line with the 
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tilde (~) escape character followed by a single command letter and optional arguments. See 
TILDE ESCAPES for a summary of these commands. 

At any time, the behavior of mailx is governed by a set of environment variables. These are flags 
and valued parameters which are set and cleared via the set and unset commands. See 
ENVIRONMENT VARIABLES below for a summary of these parameters. 

Recipients listed on the command line may be of three types: login names, shell commands, or 
alias groups. Login names may be any network address, including mixed network addressing. If 
the recipient name begins with a pipe symbol (I), the rest of the name is taken to be a shell com¬ 
mand to pipe the message through. This provides an automatic interface with any program that 
reads the standard input, such as lp{l) for recording outgoing mail on paper. Alias groups are set 
by the alias command (see COMMANDS below) and are lists of recipients of any type. 

Regular commands are of the form 

[ command ] [ msglist ] [ arguments ] 

If no command is specified in command mode, print is assumed. In input mode, commands are 
recognized by the escape character, and lines not treated as commands are taken as input for the 
message. 

Each message is assigned a sequential number, and there is at any time the notion of a ’current’ 
message, marked by a ’>’ in the header summary. Many commands take an optional list of mes¬ 
sages {msglist) to operate on, which defaults to the current message. A msglist is a list of message 
specifications separated by spaces, which may include: 

n Message number n. 

. The current message. 

The first undeleted message. 

$ The last message. 

* All messages. 

n-m An inclusive range of message numbers, 

user All messages from user. 

/string All messages with string in the subject line (case ignored). 

:c All messages of type c, where c is one of: 

d deleted messages 

n new messages 

o old messages 

r read messages 

u unread messages 

Note that the context of the command determines whether this type of message 
specification makes sense. 

Other arguments are usually arbitrary strings whose usage depends on the command involved. 
File names, where expected, are expanded via the normal shell conventions (see sh{l)). Special 
characters are recognized by certain commands and are documented with the commands below. 

At start-up time, mailx reads commands from a system-wide file (/usr/lib/mailx/mailx.rc) to 
initialize certain parameters, then from a private start-up file ($HOME/.mailrc) for personal¬ 
ized variables. Most regular commands are legal inside start-up files, the most common use being 
to set up initial display options and alias lists. The following commands are not legal in the 
start-up file: !, Copy, edit, followup. Followup, hold, mail, preserve, reply. Reply, shell, and 
visual. Any errors in the start-up file cause the remaining lines in the file to be ignored. 

COMMANDS 

The following is a complete list of mailx commands: 
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I shell-command 

Escape to the shell. See "SHELL" (ENVIRONMENT VARIABLES). 
^ comment 

Null command (comment). This may be useful in .mailrc files. 


Print the current message number. 


7 

Prints a summary of commands. 

alias alias name ... 
group alias name ... 

Declare an alias for the given names. The names will be substituted when alias is used as 
a recipient. Useful in the .mailrc file. 

alternates name ... 

Declares a list of alternate names for your login. When responding to a message, these 
names are removed from the list of recipients for the response. With no arguments, 
alternates prints the current list of alternate names. See also "allnet" (ENVIRONMENT 
VARIABLES). 

cd [directory] 
chdir [directory] 

Change directory. If directory is not specified, $HOME is used. 

copy [filename] 
copy [msglist] filename 

Copy messages to the file without marking the messages as saved. Otherwise equivalent 
to the save command. 

Copy [msglist] 

Save the specified messages in a file whose name is derived from the author of the message 
to be saved, without marking the messages as saved. Otherwise equivalent to the Save 
command. 

delete [msglist] 

Delete messages from the mailbox. If "autoprint" is set, the next message after the last 
one deleted is printed (see ENVIRONMENT VARIABLES). 

discard [header-field ...] 
ignore [header-field ...] 

Suppresses printing of the specified header fields when displaying messages on the screen. 
Examples of header fields to ignore are "status" and "cc." The fields are included when 
the message is saved. The Print and Type commands override this command. 

dp [msglist] 
dt [msglist] 

Delete the specified messages from the mailbox and print the next message after the last 
one deleted. Roughly equivalent to a delete command followed by a print command. 


Hewlett-P ackard 


- 3- 


July 2, 1985 



MAILX (1) 


MAILX(l) 


echo string ... 

Echo the given strings (like echo{l)). 


edit [msglist] 

Edit the given messages. The messages are placed in a temporary file and the "EDITOR" 
variable is used to get the name of the editor (see ENVIRONMENT VARIABLES). Default 
editor is ed{l). 


exit 

xit 

Exit from mailx, without changing the mailbox. No messages are saved in the mbox (see 
also quit). 

file [filename] 
folder [filename] 

Quit from the current file of messages and read in the specified file. Several special char¬ 
acters are recognized when used as file names, with the following substitutions: 

% the current mailbox. 

%user 

the mailbox for user. 

# the previous file. 

Si the current mbox. 

Default file is the current mailbox. 

folders 

Print the names of the files in the directory set by the "folder" variable (see ENVIRON¬ 
MENT VARIABLES). 

followup [message] 

Respond to a message, recording the response in a file whose name is derived from the 
author of the message. Overrides the "record" variable, if set. See also the Followup, 
Save, and Copy commands and "outfolder" (ENVIRONMENT VARIABLES). 

Followup [msglist] 

Respond to the first message in the msglist, sending the message to the author of each 
message in the msglist. The subject line is taken from the first message and the response 
is recorded in a file whose name is derived from the author of the first message. See also 
the followup. Save, and Copy commands and "outfolder" (ENVIRONMENT VARIABLES). 

from [msglist] 

Prints the header summary for the specified messages. 

group alias name ... 
alias alias name ... 

Declare an alias for the given names. The names will be substituted when alias is used as 
a recipient. Useful in the .mailrc file. 

headers [message] 

Prints the page of headers which includes the message specified. The "screen" variable 
sets the number of headers per page (see ENVIRONMENT VARIABLES). See also the z 
command. 
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help 

Prints a summary of commands. 

hold [msglist] 
preserve [msglist] 

Holds the specified messages in the mailbox. 


if s I r 

mail- commands, 

else 

mail-commands 

endif 

Conditional execution, where s will execute following mail-commands^ up to an else or 
endif, if the program is in send mode, and r causes the mail- commands to be executed 
only in receive mode. Useful in the .mailrc file. 

ignore header-field ... 
discard header-field ... 

Suppresses printing of the specified header fields when displaying messages on the screen. 
Examples of header fields to ignore are "status" and "cc." All fields are included when 
the message is saved. The Print and Type commands override this command. 


list 

Prints all commands available. No explanation is given, 
mail name ... 

Mail a message to the specified users, 
mbox [msglist] 

Arrange for the given messages to end up in the standard mbox save file when mailx ter¬ 
minates normally. See "MBOX" (ENVIRONMENT VARIABLES) for a description of this 
file. See also the exit and quit commands. 

next [message] 

Go to next message matching message. A msglist may be specified, but in this case the 
first valid message in the list is the only one used. This is useful for jumping to the next 
message from a specific user, since the name would be taken as a command in the absence 
of a real command. See the discussion of msglists above for a description of possible mes¬ 
sage specifications. 

pipe [msglisf\ [shell-command\ 

I [msglist] [shell-comman(J\ 

Pipe the message through the given shell-command. The message is treated as if it were 
read. If no arguments are given, the current message is piped through the command 
specified by the value of the "cmd" variable. If the "page" variable is set, a form feed 
character is inserted after each message (see ENVIRONMENT VARIABLES). 

preserve [msglist] 
hold [msglist] 

Preserve the specified messages in the mailbox. 
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Print [msglist] 

Type [msglist] 

Print the specified messages on the screen, including all header fields. Overrides suppres ¬ 
sion of fields by the ignore command. 

print [msglist] 
type [msglist] 

Print the specified messages. If "crt" is set, the messages longer than the number of lines 
specified by the "crt" variable are paged through the command specified by the 
"PAGER" variable. The default command is pg(l) (see ENVIRONMENT VARIABLES). 


quit 

Exit from mailx, storing messages that were read in mbox and unread messages in the 
mailbox. Messages that have been explicitly saved in a file are deleted. 

Reply [msglist] 

Respond [msglist] 

Send a response to the author of each message in the msglist. The subject line is taken 
from the first message. If "record" is set to a filename, the response is saved at the end of 
that file (see ENVIRONMENT VARIABLES). 

reply [message] 
respond [message] 

Reply to the specified message, including all other recipients of the message. If "record" 
is set to a filename, the response is saved at the end of that file (see ENVIRONMENT 
VARIABLES). 

Save [msglist\ 

Save the specified messages in a file whose name is derived from the author of the first 
message. The name of the file is taken to be the author’s name with all network address¬ 
ing stripped off. See also the Copy, followup, and Followup commands and "outfolder" 
(ENVIRONMENT VARIABLES). 

save [filename] 
save [msglist] filename 

Save the specified messages in the given file. The file is created if it does not exist. The 
message is deleted from the mailbox when mailx terminates unless "keepsave" is set (see 
also ENVIRONMENT VARIABLES and the exit and quit commands). 


set 

set name 

set name=string 

set name=number 

Define a variable called name. The variable may be given a null, string, or numeric value. 
Set by itself prints all defined variables and their values. See ENVIRONMENT VARI¬ 
ABLES for detailed descriptions of the mailx variables. 


shell 

Invoke an interactive shell (see also "SHELL" (ENVIRONMENT VARIABLES)), 
size [msglist] 

Print the size in characters of the specified messages. 
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source filename 

Read commands from the given file and return to command mode, 
top [msglist] 

Print the top few lines of the specified messages. If the "toplines" variable is set, it is 
taken as the number of lines to print (see ENVIRONMENT VARIABLES). The default is 5. 

touch [msglist] 

Touch the specified messages. If any message in msglist is not specifically saved in a file, 
it will be placed in the mbox upon normal termination. See exit and quit. 

Type [msglis^ 

Print [msglist\ 

Print the specified messages on the screen, including all header fields. Overrides suppres¬ 
sion of fields by the ignore command. 

type [msglist] 
print [msglist] 

Print the specified messages. If "crt" is set, the messages longer than the number of lines 
specified by the "crt" variable are paged through the command specified by the 
"PAGER" variable. The default command is pg{l) (see ENVIRONMENT VARIABLES). 


undelete [msglist] 

Restore the specified deleted messages. Will only restore messages deleted in the current 
mail session. If "autoprint" is set, the last message of those restored is printed (see 
ENVIRONMENT VARIABLES). 

unset name ... 

Causes the specified variables to be erased. If the variable was imported from the execu¬ 
tion environment (i.e., a shell variable) then it cannot be erased. 

version 

Prints the current version and release date, 
visual [msglist] 

Edit the given messages with a screen editor. The messages are placed in a temporary file 
and the "VISUAL" variable is used to get the name of the editor (see ENVIRONMENT 
VARIABLES). 

write [msglist] filename 

Write the given messages on the specified file, minus the header and trailing blank line. 
Otherwise equivalent to the save command. 

xit 

exit 

Exit from mailx, without changing the mailbox. No messages are saved in the mbox (see 
also quit). 

z[+|-] 

Scroll the header display forward or backward one screen-full. The number of headers 
displayed is set by the "screen" variable (see ENVIRONMENT VARIABLES). 

TILDE ESCAPES 

The following commands may be entered only from input mode., by beginning a line with the tilde 
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escape character (~). See "escape" (ENVIRONMENT VARIABLES) for changing this special char¬ 
acter. 

""I shell-command 

Escape to the shell. 


Simulate end of file (terminate message input). 

mail-command 

mail-command 

Perform the command-level request. Valid only when sending a message while reading 
mail. 


Print a summary of tilde escapes. 

Insert the autograph string "Sign" into the message (see ENVIRONMENT VARIABLES). 

~a 

Insert the autograph string "sign" into the message (see ENVIRONMENT VARIABLES). 
~b name ... 

Add the names to the blind carbon copy (Bcc) list. 

~c name ... 

Add the names to the carbon copy (Cc) list. 


Read in the deadJetter file. See "DEAD" (ENVIRONMENT VARIABLES) for a description 
of this file. 


Invoke the editor on the partial message. See also "EDITOR" (ENVIRONMENT VARI¬ 
ABLES). 

f [msglist] 

Forward the specified messages. The messages are inserted into the message, without 
alteration. 


~h 

Prompt for Subject line and To, Cc, and Bcc lists. If the field is displayed with an initial 
value, it may be edited as if you had just typed it. 

"'i string 

Insert the value of the named variable into the text of the message. For example, ~A is 
equivalent to Sign.’ 

~m [msglist] 

Insert the specified messages into the letter, shifting the new text to the right one tab 
stop. Valid only when sending a message while reading mail. 
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P 

Print the message being entered. 

~q 

Quit from input mode by simulating an interrupt. If the body of the message is not null, 
the partial message is saved in dead.letter. See "DEAD" (ENVIRONMENT VARIABLES) 
for a description of this file. 

''r filename 

< filename 

< \shell-command 

Read in the specified file. If the argument begins with an exclamation point (!), the rest 
of the string is taken as an arbitrary shell command and is executed, with the standard 
output inserted into the message. 

~s string ... 

Set the subject line to string. 


t name ... 

Add the given names to the To list. 


Invoke a preferred screen editor on the partial message. See also "VISUAL" (ENVIRON¬ 
MENT VARIABLES). 


w filename 

Write the partial message onto the given file, without the header. 


X 

Exit as with ~q except the message is not saved in dead.letter. 

~ 1 shell-command 

Pipe the body of the message through the given shell-command. If the shell-command 
returns a successful exit status, the output of the command replaces the message. 

ENVIRONMENT VARIABLES 

The following are environment variables taken from the execution environment and are not alter¬ 
able within mailx. 

directory 

The user’s base of operations. 

MAILRC=/?7ename 

The name of the start-up file. Default is $HOME/.mailrc. 

The following variables are internal mailx variables. They may be imported from the execution 
environment or set via the set command at any time. The unset command may be used to erase 
variables. 

allnet 

All network names whose last component (login name) match are treated as identical. 
This causes the msglist message specifications to behave similarly. Default is noallnet. 
See also the alternates command and the "metoo" variable. 
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append 

Upon termination, append messages to the end of the mbox file instead of prepending 
them. Default is noappend. 


askcc 

Prompt for the Cc list after message is entered. Default is noaskcc. 


asksub 

Prompt for subject if it is not specified on the command line with the -s option. Enabled 
by default. 

autoprint 

Enable automatic printing of messages after delete and undelete commands. Default is 

noautoprint. 


bang 

Enable the special-casing of exclamation points (!) in shell escape command lines as in 
w(l). Default is nobang. 

cm.d=shell-command 

Set the default command for the pipe command. No default value. 
conv =conversion 

Convert uucp addresses to the specified address style. The only valid conversion now is 
internet^ which requires a mail delivery program conforming to the RFC822 standard for 
electronic mail addressing. Conversion is disabled by default. See also "sendmail" and 
the -U command line option. 

crt=numher 

Pipe messages having more than number lines through the command specified by the 
value of the "PAGER" variable (p^(l) by default). Disabled by default. 

DE AD =filename 

The name of the file in which to save partial letters in case of untimely interrupt or 
delivery errors. Default is $HOME/dead.letter. 

debug 

Enable verbose diagnostics for debugging. Messages are not delivered. Default is node¬ 
bug. 

dot 

Take a period on a line by itself during input from a terminal as end-of-file. Default is 

nodot. 

F,T)TTOIl=shell-command 

The command to run when the edit or ~e command is used. Default is ed(l). 
escape=c 

Substitute c for the ~ escape character, 
folder =dire c tory 

The directory for saving standard mail files. User specified file names beginning with a 
plus (+) are expanded by preceding the filename with this directory name to obtain the 
real filename. If directory does not start with a slash (/), $HOME is prepended to it. In 
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order to use the plus (+) construct on a mailx command line, "folder" must be an 
exported sh environment variable. There is no default for the "folder" variable. See also 
"outfolder" below. 


header 

Enable printing of the header summary when entering mailx. Enabled by default. 

hold 

Preserve all messages that are read in the mailbox instead of putting them in the standard 
mbox save file. Default is nohold. 

ignore 

Ignore interrupts while entering messages. Handy for noisy dial-up lines. Default is 

noignore. 

ignoreeof 

Ignore end-of-file during message input. Input must be terminated by a period (.) on a 
line by itself or by the command. Default is noignoreeof. See also "dot" above. 


keep 

When the mailbox is empty, truncate it to zero length instead of removing it. Disabled 
by default. 

keepsave 

Keep messages that have been saved in other files in the mailbox instead of deleting them. 
Default is nokeepsave. 

MBOX=filename 

The name of the file to save messages which have been read. The xit command overrides 
this function, as does saving the message explicitly in another file. Default is 
$HOME/mbox. 


metoo 

If your login appears as a recipient, do not delete it from the list. Default is nometoo. 


L1STE'R=shell-command 

The command (and options) to use when listing the contents of the "folder" directory. 
The default is /5(1). 


onehop 

When responding to a message that was originally sent to several recipients, the other 
recipient addresses are normally forced to be relative to the originating author’s machine 
for the response. This flag disables alteration of the recipients’ addresses, improving 
efficiency in a network where all machines can send directly to all other machines (i.e., 
one hop away). 

outfolder 

Causes the files used to record outgoing messages to be located in the directory specified 
by the "folder" variable unless the pathname is absolute. Default is nooutfolder. See 
"folder" above and the Save, Copy, followup, and Followup commands. 


page 

Used with the pipe command to insert a form feed after each message sent through the 
pipe. Default is nopage. 
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PAG'EIt=shell-command 

The command to use as a filter for paginating output. This can also be used to specify 
the options to be used. Default is pg(l). 

proinpt=string 

Set the command mode prompt to string. Default is "? ". 

quiet 

Refrain from printing the opening message and version when entering mailx. Default is 

noquiet. 

record =filename 

Record all outgoing mail in filename. Disabled by default. See also "outfolder" above. 

save 

Enable saving of messages in dead.letter on interrupt or delivery error. See "DEAD" for a 
description of this file. Enabled by default. 

scr een=number 

Sets the number of lines in a screen-full of headers for the headers command. 
senduiSLil^shell-command 

Alternate command for delivering messages. Default is mail{l). 

sendwait 

Wait for background mailer to finish before returning. Default is nosendwait. 
S'H.EiLL=shell-command 

The name of a preferred command interpreter. Default is sh{l). 

showto 

When displaying the header summary and the message is from you, print the recipient’s 
name instead of the author’s name. 

sign=string 

The variable inserted into the text of a message when the ~a (autograph) command is 
given. No default (see also ~i (TILDE ESCAPES)). 

Sign=string 

The variable inserted into the text of a message when the ~A command is given. No 
default (see also ~i (TILDE ESCAPES)). 

toplines=number 

The number of lines of header to print with the top command. Default is 5. 
VISUAL=5/ie//-comman(/ 

The name of a preferred screen editor. Default is m’(l). 

FILES 

$HOME/.mailrc personal start-up file 

$HOME/mbox secondary storage file 

/usr/mail/* post office directory 

/usr/lib/mailx/mailx.help* help message files 
/usr/lib/mailx/mailx.rc global start-up file 
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/tmp/R[emqsx]* temporary files 

SEE ALSO 

mail(l), pg(l), ls(l). 

BUGS 

Where shell command is shown as valid, arguments are not always allowed. Experimentation is 
recommended. 

Internal variables imported from the execution environment cannot be unset. 

The full internet addressing is not fully supported by mailx. The new standards need some time 
to settle down. 

Attempts to send a message having a line consisting only of a are treated as the end of the 
message by mail{l) (the standard mail delivery program). 
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NAME 

make - maintain, update, and regenerate groups of programs 
SYNOPSIS 

make [-f makefile] [-p] [-i] [-k] [-s] [-r] [-n] [-b] [-e] [-t] [-d] [-q] [ names ] 

HP-UX COMPATIBILITY 

Level; HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

The following is a brief description of all options and some special names. Options may occur in 
any order. 

-f makefile Description file name. Makefile is assumed to be the name of a description file. A file 
name of - denotes the standard input. The contents of makefile override the built-in 
rules if they are present. Note that the space between -f and makefile must be 
present. 

-p Print out the complete set of macro definitions and target descriptions. 

-i Ignore error codes returned by invoked commands. This mode is also entered if the 

fake target name .IGNORE appears in the description file. 

-k When a command returns nonzero status, abandon work on the current entry, but 

continue on other branches that do not depend on that entry. 

-s Silent mode. Do not print command lines before executing. This mode is also entered 

if the fake target name .SILENT appears in the description file. 

-r Do not use the built-in rules. 

-n No execute mode. Print commands, but do not execute them. Even lines beginning 

with an @ are printed. 

-b Compatibility mode for old (Version 7) makefiles. 

-e Environment variables override assignments within makefiles. 

-t Touch the target files (causing them to be up-to-date) rather than issue the usual 

commands. 

-d Debug mode. Print out detailed information on files and times examined. (This is 

intended for debugging the make command itself.) 

-q Question. The make command returns a zero or non-zero status code depending on 

whether the target file is or is not up-to-date. 

The "built-in" dependency targets are: 

.DEFAULT 

If a file must be made but there are no explicit commands or relevant built-in rules, the 
commands associated with the name .DEFAULT are used if it exists. 

.PRECIOUS 

Dependents of this target will not be removed when quit or interrupt are hit. 

.SILENT 

Same effect as the -s option. 

.IGNORE 

Same effect as the -i option. 

Make executes commands in makefile to update one or more target names. Name is typically a 
program. If no -f option is present, makefile, Makefile, s.makefile, and s.Makefile are tried in 
order. If makefile is -, the standard input is taken. More than one -f makefile argument pair may 


Hewlett-P ackard 


July 2, 1985 



MAKE(l) 


MAKE(l) 


appear. 

Make updates a target only if it depends on files that are newer than the target. All prerequisite 
files of a target are added recursively to the list of targets. Missing files are deemed to be out of 
date. 

Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a 
blank-separated, non-null list of targets, followed by a colon (;), followed by a (possibly null) list 
of prerequisite files or dependencies. Text following a ; and all following lines that begin with a 
tab are shell commands to be executed to update the target. The first line that does not begin 
with a tab or # begins a new dependency or macro definition. Shell commands may be continued 
across lines with the <backslash><new-line> sequence. Everything printed by make (except the 
initial tab) is passed directly to the shell as is. Thus, 

echo a\ 
b 

will produce 
ab 

exactly the same as the shell would. 

Sharp (#) and new-line surround comments. 

The following makefile says that pgm depends on two files a.o and b.o, and that they in turn 
depend on their corresponding source files (a.c and b.c) and a common file incl.h: 

pgm: a.o b.o 

cc a.o b.o -o pgm 

a. o: incl.h a.c 

cc -c a.c 

b. o: incl.h b.c 

cc -c b.c 

Command lines are executed one at a time, each by its own shell. The first one or two characters 
in a command can be the following: -, @, or If @ is present, printing of the command is 
suppressed. If — is present, make ignores an error. A line is printed when it is executed unless 
the -s option is present, or the entry .SILENT: is in makefile, or unless the initial character 
sequence contains a @. The -n option specifies printing without execution; however, if the com¬ 
mand line has the string $(MAKE) in it, the line is always executed (see discussion of the 
MAKEFLAGS macro under Environment). Note that this feature does not work if MAKE is 
enclosed in braces, as in ${MAKE}. The -t (touch) option updates the modified date of a file 
without executing any commands. 

Commands returning non-zero status normally terminate make. If the -i option is present, or the 
entry .IGNORE: appears in makefile, or the initial character sequence of the command contains 
-. the error is ignored. If the -k option is present, work is abandoned on the current entry, but 
continues on other branches that do not depend on that entry. 

The -b option allows old makefiles (those written for the old version of make) to run without 
errors. The difference between the old version of make and this version is that this version 
requires all dependency lines to have a (possibly null or implicit) command associated with them. 
The previous version of make assumed, if no command was specified explicitly, that the command 
was null. 

Interrupt and quit cause the target to be deleted unless the target depends on the special name 

.PRECIOUS. 

Environment 

The environment is read by make. All variables are assumed to be macro definitions and pro¬ 
cessed as such. The environment variables are processed before any makefile and after the 


Hewlett-Packard 


-2- 


July 2, 1985 



MAKE(1) 


MAKE(l) 


internal rules; thus, macro assignments in a makefile override environment variables. The -e 
option causes the environment to override the macro assignments in a makefile. 

The MAKEFLAGS environment variable is processed by make as containing any legal input 
option (except -f, -p, and -d) defined for the command line. Further, upon invocation, make 
“invents” the variable if it is not in the environment, puts the current options into it, and passes 
it on to invocations of commands. Thus, MAKEFLAGS always contains the current input 
options. This proves very useful for “super-makes”. In fact, as noted above, when the -n option 
is used, the command $(MAKE) is executed anyway; hence, one can perform a make -n recur¬ 
sively on a whole software system to see what would have been executed. This is because the -n 
is put in MAKEFLAGS and passed to further invocations of $(MAKE). This is one way of 
debugging all of the makefiles for a software project without actually doing anything. 

Macros 

Entries of the form stringl = string2 are macro definitions. Stnng2 is defined as all characters up 
to a comment character or an unescaped new-line. Subsequent appearances of %(stringl[.substl = 
[subst2]]) are replaced by string2. The parentheses are optional if a single character macro name 
is used and there is no substitute sequence. The optional :substl=subst2 is a substitute sequence. 
If it is specified, all non-overlapping occurrences of substl in the named macro are replaced by 
subst2. Strings (for the purposes of this type of substitution) are delimited by blanks, tabs, new- 
line characters, and beginnings of lines. An example of the use of the substitute sequence is 
shown under Libraries. 

Internal Macros 

There are five internally maintained macros which are useful for writing rules for building targets. 

$* The macro $* stands for the file name part of the current dependent with the suffix deleted. 
It is evaluated only for inference rules. 

$@ The $@ macro stands for the full target name of the current target. It is evaluated only for 
explicitly named dependencies. 

$< The $< macro is only evaluated for inference rules or the .DEFAULT rule. It is the module 
which is out-of-date with respect to the target (i.e., the “manufactured” dependent file 
name). Thus, in the .c.o rule, the $< macro would evaluate to the .c file. An example for 
making optimized .o files from .c files is: 

.c.o: 

cc -c -O $*.c 


or: 


.c.o: 

cc -c -O $< 

$? The $? macro is evaluated when explicit rules from the makefile are evaluated. It is the list 
of prerequisites that are out of date with respect to the target; essentially, those modules 
which must be rebuilt. 

$% The $% macro is only evaluated when the target is an archive library member of the form 
lib (file.o). In this case, $@ evaluates to lib and $% evaluates to the library member, 

file.o. 
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Four of the five macros can have alternative forms. When an upper case D or F is 
appended to any of the four macros, the meaning is changed to “directory part” for D and 
“file part” for F. Thus, $(@D) refers to the directory part of the string $@. If there is no 
directory part, ./ is generated. The only macro excluded from this alternative form is $?. 
The reasons for this are debatable. 

Suffixes 

Certain names (for instance, those ending with .o) have inferable prerequisites such as .c, .s, etc. 
If no update commands for such a file appear in makefile, and if an inferable prerequisite exists, 
that prerequisite is compiled to make the target. In this case, make has inference rules which 
allow building files from other files by examining the suffixes and determining an appropriate 
inference rule to use. The current default inference rules are: 

.c .c~ .sh .sh~ .c.o .c~.o .c~.c .s.o .s~.o .y.o .y~.o .l.o .T.o 
.y.c .y~.c .l.c .c.a .c~.a .s'.a .h~.h 

To print out the rules compiled into the make on any machine in a form suitable for recompila 
tion, the following command is used: 

make -fp - 2>/dev/null </dev/null 

The only peculiarity in this output is the (null) string which printf{SS) prints when handed a null 
string. 

A tilde in the above rules refers to an SCCS file (see sccsfile(b)). Thus, the rule .c^.o would 
transform an SCCS C source file into an object file (.o). Because the s. of the SCCS files is a 
prefix, it is incompatible with makers suffix point-of-view. Hence, the tilde is a way of changing 
any file reference into an SCCS file reference. 

A rule with only one suffix (i.e., .c:) is the definition of how to build x from x.c. In effect, the 
other suffix is null. This is useful for building targets from only one source file (e.g., shell pro¬ 
cedures, simple C programs). 

Additional suffixes are given as the dependency list for .SUFFIXES. Order is significant; the first 
possible name for which both a file and a rule exist is inferred as a prerequisite. 

The default list is: 

.SUFFIXES: .0 .c .y .1 .s 

Here again, the above command for printing the internal rules will display the list of suffixes 
implemented on the current machine. Multiple suffix lists accumulate; .SUFFIXES: with no 
dependencies clears the list of suffixes. 

Inference Rules 

The first example can be done more briefly: 

pgm: a.o b.o 

cc a.o b.o -o pgm 
a.o b.o: incl.h 

This is because make has a set of internal rules for building files. The user may add rules to this 
list by simply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the inclusion of optional matter 
in any resulting commands. For example, CFLAGS, LFLAGS, and YFLAGS are used for com¬ 
piler options to cc(l), lex{l), and yacc{l), respectively. Again, the previous method for examin 
ing the current rules is recommended. 

The inference of prerequisites can be controlled. The rule to create a file with suffix .0 from a file 
with suffix .c is specified as an entry with .c.o: as the target and no dependents. Shell commands 
associated with the target define the rule for making a .0 file from a .c file. Any target that has 
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no slashes in it and starts with a dot is identified as a rule and not a true target. 

Libraries 

If a target or dependency name contains parentheses, it is assumed to be an archive library, the 
string within parentheses referring to a member within the library. Thus lib (file.o) and 
$(LIB)(file.o) both refer to an archive library which contains file.o. (This assumes the LIB 
macro has been previously defined.) The expression $(LIB)(filel.o file2.o) is not legal. Rules 
pertaining to archive libraries have the form .XX.a where the XX is the suffix from which the 
archive member is to be made. An unfortunate byproduct of the current implementation requires 
the XX to be different from the suffix of the archive member. Thus, one cannot have lib (file.o) 
depend upon file.o explicitly. The most common use of the archive interface follows. Here, we 
assume the source files are all C type source: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

@echo lib is now up-to-date 

.c.a: 

$(CC) -c $(CFLAGS) $< 
ar rv $@ $*.o 
rm -f $*.o 

In fact, the .c.a rule listed above is built into make and is unnecessary in this example. A more 
interesting, but more limited example of an archive library maintenance construction follows: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

$(CC) -c $(CFLAGS) $(?:.o=.c) 
ar rv lib $? 

rm $? @echo lib is now up-to-date 


Here the substitution mode of the macro expansions is used. The $? list is defined to be the set 
of object file names (inside lib) whose C source files are out-of-date. The substitution mode 
translates the .o to .c. (Unfortunately, one cannot as yet transform to .c~; however, this may 
become possible in the future.) Note also, the disabling of the .c.a: rule, which would have 
created each object file, one by one. This particular construct speeds up archive library mainte¬ 
nance considerably. This type of construct becomes very cumbersome if the archive library con¬ 
tains a mix of assembly programs and C programs. 

FILES 

[Mmjakefile and s.[Mm]akefile 

SEE ALSO 

cc(l), cd(l), lex(l), sh(l), yacc(l). 

WARNING 

Be wary of any file (such as an include file) whose access, modification, and last change times can¬ 
not be altered by the make-mg process. For example, if a program depends on an include file 
which in turn depends on another include file, and if one or both of these files are out-of-date, 
make will try to update these files each time it is run, thus unnecessarily re-makemg up-to-date 
files dependent on the include file. The solution is to manually update these files with the 
touch{l) command before running make. (Note that it is generally a bad idea to include the 
touch{l) command in your makefile, because it can cause make to update a program that other¬ 
wise did not need to be updated.) 

BUGS 

Some commands return non-zero status inappropriately; use -i to overcome the difficulty. 

File names with the characters = : @ will not work. 

Commands that are directly executed by the shell, notably cd(l), are ineffectual across new-lines 
in make. 
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The syntax lib(filel.o file2.o fileS.o) is illegal. 

You cannot build lib (file.o) from file.o. 

The macro $(a:.o=.c~) does not work. 

There is a limit of 2500 characters, including the terminating new -line, for expanded dependency 
lines. 

Make will not properly expand a macro within another macro when string substitution is involved. 
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NAME 

man - find manual information by keywords; print out the manual 

SYNOPSIS 

man -k keyword ... 
man -f file ... 

man [ - ] [ section ] title ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

DESCRIPTION 

Man is a program which gives information from the programmer’s manual. It can be asked to 
form one line descriptions of commands specified by name, or for all commands whose description 
contains any of a set of keywords. It can also provide on-line access to the sections of the printed 
manual. 

When given the option -k and a set of keywords, man prints out a one line synopsis of each 
manual section whose listing in the table of contents contains that keyword. 

When given the option -f and a list of file names, man attempts to locate manual sections related 
to those files, printing out the table of contents lines for those sections. 

When neither -k nor -f is specified, man formats a specified set of manual pages. If a section 
specifier is given man looks in that section of the manual for the given titles. Section is an arabic 
section number, i.e. 3, which may be followed by a single letter classifier, i.e. Ig indicating a 
graphics program in section 1. If section is omitted, man searches all sections of the manual, giv¬ 
ing preference to commands over subroutines in system libraries, and printing the first section it 
finds, if any. 

If the standard output is a teletype, or if the flag - is given, then man pipes its output through 
rmn/(l) to delete useless blank lines, w/(l) to create proper underlines for different terminals, and 
through more(l) to stop after each page. Hit a space to continue. 

If the /usr/man/cat? directory is present and the file is not in it, but the file exists in 
/usr/man/man?, then the page is formatted and installed in /usr/man/cat? on first access. If 
only the /usr/man/cat? directories are present and/or nroff is not installed then only those pages 
which have been preformatted are display able. 

The Berkeley command whatis{l) is provided by man -f. 

FILES 

/usr / man/man? / * 

/usr/man/cat?/* 

/usr/local/man?/* 

/usr/local/cat?/* 

/usr/contrib/man? / * 

/usr/contrib/cat?/* 

SEE ALSO 

rmnl(l), ul(l), more(l), whereis(l), catman(lM). 

BUGS 

The manual is supposed to be reproducible either on the phototypesetter or on a typewriter. 
However, on a typewriter some information is necessarily lost. 
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NAME 

mediainit - initialize hard disc, flexible disc, or cartridge tape media 

SYNOPSIS 

mediainit [—vr] [—f fmt_optn] [-i interleave] pathname 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: Mediainit is implemented on Series 200 only. 

DESCRIPTION 

Mediainit initializes mass storage media by formatting the media, writing and reading test pat¬ 
terns to verify media integrity, then sparing any defective blocks found. This process prepares the 
disc or tape for error-free operation. 

The following command options are recognized. They can be specifled in any order, but all must 
precede the pathname. Options without parameters can be listed individually or grouped 
together. Options with parameters must be listed individually, but white space between the 
option and its parameter is discretionary. 

—V Normally, mediainit provides only fatal error messages, and they are directed to diagnostic 
output (stderr). The verbose option sends device-speciflc error information related to low- 
level operation of mediainit to standard output (stdout). This option is most useful to 
trained service personnel because it usually requires detailed knowledge of device operation 
before the error information can be interpreted correctly. 

-r The re-certify option forces a complete tape certification whether or not the tape has been 
certified previously. All record of any previously spared blocks is discarded, so any bad 
blocks will have to be rediscovered. This option should be used only if: (a) it is suspected 
that numerous blocks on the tape have been spared which should not have been, or (b) it is 
necessary to destroy (overwrite) all previous data on the tape. 

-f fmt—optn 

The format option is a device-specific number in the range 0 through 239. It is intended 
solely for use with certain SS/80 devices that support multiple media formats (disregarding 
interleave factor). For example, certain microfloppy drives support 256, 512, and 1024-byte 
sectors. Mediainit passes any supplied format option directly through to the device. The 
device then either accepts it or rejects it if it is not supported. Refer to device operating 
manuals for additional information. The default format option is 0. 

-i interleave 

Interleave refers to relationship between sequential logical records and sequential physical 
records. It defines the number of physical records that lie between the beginning points of 
two consecutively numbered logical records. The choice of interleave factor can have a sub¬ 
stantial impact on disc performance. For CS/80 and SS/80 devices, consult the appropri¬ 
ate operating manual for details. Acceptable interleave factors for non-CS/80 devices are as 
follows: 



Device 

Range 

Default 



HP9895 SS/DS 

1 - 29 

2 



HP8290X 

1 - 15 

3 



HP9121 

1 - 15 

2 



HP913X_A 

na 

9 



HP913X_B 

na 

9 



HP913X_C 

na 

9 


Hewlett-Packard 


- 1 - 


November 15, 1985 





MEDIAINIT(l) 


Series 200 Only 


MEDIAINIT (1) 


The following operand is required: 

Pathname is the path name to the character (raw) device special file associated with the volume 
(or single-volume device) containing the media to be initialized. Mediainit aborts if you lack 
either read or write permission to the device special file, or if the volume has already been opened 
by any other process. Also, mediainit locks the volume during initialization so that no other 
processes can access it. Thus it is impossible to initialize any mounted volume; in particular, the 
root volume. 

For CS/80 and SS/80 drives, a given device may contain multiple units or a given unit may con¬ 
tain multiple volumes. Any available volume can be initialized, even while other volumes are 
open. However, the initialization process tends to dominate device resources while initialization is 
in progress,thus causing delays in handling requests from other processes that need to access the 
same drive. In the case of non-CS/80 devices, the entire device is locked and no other processes 
can access the device until the target unit is completely initialized. 

In general, mediainit attempts to carefully scrutinize any format or interleave options supplied, 
and aborts if an option is out of range or inappropriate for the media being initialized. Specifying 
an interleave factor or format option value of 0 has the same effect as not specifying the option at 
all. 

For discs that support interleave factors, the acceptable range is usually 1 (no interleave) through 
N-1, where N is the number of sectors per track. With SS/80 hard discs, the optimum interleave 
factor is usually determined by the speed (normal or high) of the HP-IB interface card used and 
whether DMA is present in the system. The optimum interleave factor for SS/80 flexible disc 
drives is usually a constant (often 2), and is independent of the type of HP-IB interface used. The 
optimum interleave factor for CS/80 discs is usually 1, and is also usually not related to the type 
of HP-IB interface being used. In any case, refer to the appropriate device operating manual for 
recommended values. 

If a disc being initialized requires an interleave factor but none is specified, mediainit provides an 
appropriate, though not necessarily optimum default. For CS/80 and SS/80 discs, mediainit uses 
whatever the device reports as its current interleave factor. SS/80 floppy drives report their 
minimum (usually best) interleave factor, if the currently installed media is unformatted. 

When a given device supports format options, the allowable range of interleave factors may be 
related to the specified format option. In such instances, mediainit cannot range-check the inter¬ 
leave factor if one is specified. 

Mediainit returns a value of 0 upon successful completion, a value of 1 if there was a device- 
related error, or a value of 2 if there was a syntax-related error. 

EXAMPLES 

The following example formats an HP 9122 SS/80 3 1/2" flexible disc with an interleave factor of 
2, 1024-byte sectors, double-sided HP format: 

mediainit -i 2 -f 3 /dev/r9122 

Using defaults, the next example initializes an HP 9135A non-CS/80 4.6-Mbyte Winchester hard 
disc with an interleave factor of 9, HP format, with the verbose mode switch invoked. 

mediainit -v /dev/r9135A 

SEE ALSO 

mkfs(lM), lifinit(l). 

DIAGNOSTICS 

Appropriate error messages are given. 

WARNINGS 

Aborting mediainit is likely to leave the medium in a useless state, even if it was previously ini¬ 
tialized. 
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BACKGROUND INFORMATION 

Most types of mass storage media must be initialized before they can be used. HP hard discs, 
flexible discs, and cartridge tapes require some form of initialization, but 9-track tapes do not. 
Initialization usually involves formatting the media, writing and reading test patterns, then spar¬ 
ing any defective blocks. Depending upon the media and device type, none, some, or all of the ini¬ 
tialization process may have been performed at the factory. Mediainit completes whatever steps 
are appropriate for the media to prepare it for error-free operation. 

Most HP hard discs are formatted and exhaustively tested at the factory by use of a process more 
thorough but also more time-consuming than appropriate for mediainit. However, mediainit is still 
valuable for ensuring the integrity of the media after factory shipment, formatting with the 
correct interleave factor, and sparing any blocks which may have become defective since original 
factory testing was performed. 

HP flexible discs are not usually formatted prior to shipment, so they must undergo the entire ini¬ 
tialization process before they can be used. 

All HP CS/80 cartridge tapes are formatted prior to shipment from the factory, but certification 
is optional at additional cost. If the tape is certified, it has been tested and sparing is already 
complete. Mediainit usually certifies a tape only if it has not been certified previously. On 
previously-certified tapes, mediainit usually re-organizes the tape’s spare block table, retaining any 
previous spares, but optimizing their assignment for maximum performance under sequential 
access. Re-organizing the spare block table takes only a few seconds, whereas complete 
certification takes about a half-hour for 150-foot tapes, and over an hour for 600-foot tapes. 

HP CS/80 cartridge tape drives have a feature called "auto-sparing", where if under normal usage 
the drive has trouble reading a block, the drive logs the fact then automatically spares out that 
block the next time data is written to it. Thus, as a tape is used, any marginal blocks that were 
not spared during certification are spared automatically if they cause problems. This sparing is 
automatic within the device, and is totally independent of Mediainit. 

Reorganization of a tape’s spare block table technically renders any existing data undefined, but 
the data is not usually destroyed by overwriting. To ensure that old tape data is destroyed (use¬ 
ful for security reasons among other things), complete tape re-certification can forced with the -r 
option. 

Some applications may require that a file system be placed on the media before use. Mediainit 
does not create a file system; it only prepares media for writing and reading. Other utilities such 
as newfs(lm) or lifinit{\) must be invoked after running mediainit, if such a file system is 
required. 


Hewlett-Packard 


- 3- 


November 15, 1985 



MESG(l) 


MESG (1) 


NAME 

mesg - permit or deny messages to terminal 

SYNOPSIS 

mesg [ n ] [ y ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Mesg with argument n forbids messages via write (1) by revoking non-user write permission on 
the user’s terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the 
current state without changing it. 

FILES 

/dev/tty* 

SEE ALSO 

write(l). 

DIAGNOSTICS 

Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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NAME 

rnkdir - make a directory 

SYNOPSIS 

rnkdir dirname ... 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

Native Language Support: 

8-bit filenames. 

DESCRIPTION 

Mkdir creates specified directories in mode 777 (possibly altered by umask{l)). Standard entries, 
for the directory itself, and for its parent, are made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

sh(l), rm(l), umask(l). 

DIAGNOSTICS 

Mkdir returns exit code 0 if all directories were successfully made; otherwise, it prints a diagnostic 
and returns non-zero. 
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NAME 

mkstr - extract error messages from C source into a file 
SYNOPSIS 

mkstr [ - ] messagefile prefix file ... 

HP-UX COMPATIBILITY 

Level: HP-UX/DEVELOPMENT 

Origin: UCB 

DESCRIPTION 

Mkstr examines a C program and creates a file containing error message strings used by the pro¬ 
gram. Programs with many error diagnostics can be made much smaller by referring to places in 
the file, and reduce system overhead in running the program. 

Mkstr processes each of the specified files, placing a revised version of each in a file whose name 
consists of the specified prefix concatenated to the original name. A typical usage of mkstr would 
be 

mkstr my strings xx *.c 

This command would cause all the error messages from the C source files in the current directory 
to be placed in the file mystrings and revised copies of the source for these files to be placed in 
files whose names are prefixed with xx. 

To process the error messages in the source to the message file mkstr keys on the string error (" in 
the input file. Each time it is encountered, the C string starting after the is placed in the mes¬ 
sage file followed by a null character and a new-line character; the null character terminates the 
message so it can be easily used when retrieved, and the new-line character makes it possible to 
sensibly cat the error message file to see its contents. 

The new copy of the input file is the same as the original, except that each occurrence of a string 
that is in the error message file is replaced by an offset pointer usable by Iseek to retrieve the 
message. 

The optional - on the command line causes the error messages to be placed at the end of the 
specified message file instead of overwriting it. When many source files constitute a large mkstr ed 
program, this can be used to avoid reprocessing all the files. 

All functions used by the original program whose names end in "error" and that can take a con¬ 
stant string as their first argument should be rewritten so that they search for the string in the 
error message file. 

For example: 


^include <stdio.h> 

# include <sys/types.h> 
#include <fcntl.h> 

char errfile[] = "mystrings"; 

error(offset, a2, a3, a4) 
int offset, al, a2, a3; 

{ 

char msg[256]; 
static int fd = -1; 

if (fd < 0) 

{ 
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fd = open(errfile, 0_RD0NLY); 
if (fd < 0) 

{ 

perror(errfile); 

exit(l); 

} 

} 

if (lseek(fd, (off_t) offset, 0) I I read(fd, msg, 256) <= 0) 

{ 

printf("? Can’t find error message in %s:\n", errfile); 

perror(errfile); 

exit(l); 

} 

printf(msg, al, a2, a3); 

} 

SEE ALSO 

lseek(2), perror(3C), xstr(l) 

BUGS 

Strings in calls to functions whose names end in ’error’, notably perror(3C), may be replaced with 
offsets. 

Calls to error functions whose first argument is not a string constant are left unmodified without 
warning. 
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NAME 

mm, osdd, checkmm - print/check documents formatted with the MM macros 
SYNOPSIS 

mm [ options ] [ files ] 
osdd [ options ] [ files ] 
checkmm [ files ] 

HP-UX COMPATIBILITY 

Level: HP-UX/EXTENDED 

Origin; System III 

DESCRIPTION 

Mm can be used to type out documents using nroff{l) and the MM text-formatting macro pack¬ 
age. It has options to specify preprocessing by ^6/(1) and/or neqn(l) and postprocessing by vari¬ 
ous terminal-oriented output filters. The proper pipelines and the required arguments and flags 
for nr off (1) and MM are generated, depending on the options selected. 

Osdd is equivalent to the command mm -mosd. For more information about the OSDD adapter 
macro package, see mosd[h). 

Options for mm are given below. Any other arguments or flags (e.g., -rC3) are passed to nroff(l) 
or to MM, as appropriate. Such options can occur in any order, but they must appear before the 
files arguments. If no arguments are given, mm prints a list of its options. 

-Tterm Specifies the type of output terminal; for a list of recognized values for term^ type help 
term2. If this option is not used, mm will use the value of the shell variable $TERM 
from the environment (see profile(b) and environ{7)) as the value of term^ if $TERM is 
set; otherwise, mm will use 450 as the value of term. If several terminal types are 
specified, the last one takes precedence. 

-12 Indicates that the document is to be produced in 12-pitch. May be used when $TERM 
is set to one of 300, 300s, 450, and 1620. (The pitch switch on the DASI 300 and 300s 
terminals must be manually set to 12 if this option is used.) 

-c Causes mm to invoke co/(l); note that co/(l) is invoked automatically by mm unless 

term is one of 300, 300s, 450, 37, 4000a, 382, 4014, tek, 1620, and X. 

-e Causes mm to invoke ne^n; also causes neqn to read the /usr/pub/eqnchar file (see 

eqnchar{b)). 

-t Causes mm to invoke ^6/(1). 

-E Invokes the -e option of nroff. 

-y Causes mm to use the non-compacted version of the macros (see mm (7)). 

As an example (assuming that the shell variable $TERM is set in the environment to 450), the 
two command lines below are equivalent: 

mm -t -rC3 -12 ghh* 

tbl ghh* I nroff -cm -T450-12 -h -rC3 

Mm reads the standard input when - is specified instead of any file names. (Mentioning other 
files together with - leads to disaster.) This option allows mm to be used as a filter, e.g.: 

cat dws I mm - 

Checkmm is a program for checking the contents of the named files for errors in the use of the 
Memorandum Macros, missing or unbalanced neqn delimiters, and .EQ/.EN pairs. Note: The 
user need not use the checkeq program (see eqn{l)). Appropriate messages are produced. The 
program skips all directories, and if no file name is given, standard input is read. 

HINTS 

1. Mm invokes nroff with the -h flag. With this flag, nroff assumes that the terminal has 
tabs set every 8 character positions. 
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2. Use the -olist option of nroff to specify ranges of pages to be output. Note, however, that 
mm, if invoked with one or more of the -e, -t, and - options, together with the -olist 
option of nroff may cause a harmless “broken pipe” diagnostic if the last page of the 
document is not specified in list. 

3. If you use the -s option of nroff (to stop between pages of output), use line feed (rather 
than return or new-line) to restart the output. The -s option of nroff does not work with 
the -c option of mm, or if mm automatically invokes col(l) (see -c option above). 

4. If you lie to mm about the kind of terminal its output will be printed on, you’ll get (often 
subtle) garbage; however, if you are redirecting output into a file, use the -T37 option, 
and then use the appropriate terminal filter when you actually print that file. 

SEE ALSO 

col(l), cw(l), env(l), eqn(l), greek(l), mmt(l), nroff(l), tbl(l), profile(5), mm(7), mosd(7), 

term(7). 

MM-Memorandum Macros in HP-UX Concepts and Tutorials. 

DIAGNOSTICS 

mm “mm: no input file” if none of the arguments is a readable file and mm is not used as a 
filter. 

checkmm “Cannot open filename^' if file(s) is unreadable. The remaining output of the program 
is diagnostic of the source file. 
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NAME 

more - file perusal filter for crt viewing 

SYNOPSIS 

more [ -cdflsu ] [ -n ] [ +linenumber ] [ +/pattern ] [ name ... ] 
page [ more options ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

Native Language Support: 

8-bit data. 


DESCRIPTION 

More is a filter which allows examination of continuous text, one screenful at a time, on a soft- 

copy terminal. It normally pauses after each screenful, printing - -More-- at the bottom of the 

screen. If the user then types a carriage return, one more line is displayed. If the user hits a 

space, another screenful is displayed. Other possibilites are enumerated later. 

The command line options are: 

-n An integer which is the size (in lines) of the window which more will use instead of the 
default. 

-c More will draw each page by beginning at the top of the screen and erasing each line just 
before it draws on it. This avoids scrolling the screen, making it easier to read while more 
is writing. This option will be ignored if the terminal does not have the ability to clear to 
the end of a line. 

-d More will prompt the user with the message "Hit space to continue, Rubout to abort" at 
the end of each screenful. This is useful if more is being used as a filter in some setting, 
such as a class, where many users may be unsophisticated. 

-f This causes more to count logical lines, rather than screen lines. That is, long lines are 
not folded. This option is recommended if nr off output is being piped through ul, since 
the latter may generate escape sequences. These escape sequences contain characters 
which would ordinarily occupy screen postions, but which do not print when they are sent 
to the terminal as part of an escape sequence. Thus more may think that lines are longer 
than they actually are, and fold lines erroneously. 

-1 Do not treat "L (form feed) specially. If this option is not given, more will pause after 
any line that contains a "L, as if the end of a screenful had been reached. Also, if a file 
begins with a form feed, the screen will be cleared before the file is printed. 

-s Squeeze multiple blank lines from the output, producing only one blank line. Especially 
helpful when viewing nr off output, this option maximizes the useful information present 
on the screen. 

-u Normally, more will handle underlining and bold such as produced by nroff in a manner 
appropriate to the particular terminal: if the terminal can perform underlining or has a 
stand-out mode, more will output appropriate escape sequences to enable underlining, 
else stand-out mode, for underlined information in the source file. If the terminal can 
perform stand-out, more uses that mode for bold information. The -u option suppresses 
this processing, as do the "ul" and "os" terminfo flags. 

-\-linenumher 

Start up at linenumber. 

I pattern 

Start up two lines before the line containing the regular expression pattern. 
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If the program is invoked as page^ then the screen is cleared before each screenful is printed (but 
only if a full screen is being printed), and k - I rather than k - 2 lines are printed in each screen¬ 
ful, where k is the number of lines the terminal can display. More looks in the file 
/usr/lib/terminfo to determine terminal characteristics, and to determine the default window size. 
On a terminal capable of displaying 24 lines, the default window size is 22 lines. 

More looks in the environment variable MORE to pre-set any flags desired. For example, if you 
prefer to view files using the -c mode of operation, the shell command sequence MORE='-c' ; 
export MORE or the csh command setenv MORE -c would cause all invocations of more, includ¬ 
ing invocations by programs such as man and msgs, to use this mode. Normally, the user will 
place the command sequence which sets up the MORE environment variable in the .profile or 
.cshrc file. 

If more is reading from a file, rather than a pipe, then a percentage is displayed along with the 
--More- - prompt. This gives the fraction of the file (in characters, not lines) that has been read 
so far. 

Other sequences which may be typed when more pauses, and their effects, are as follows [i is an 
optional integer argument, defaulting to 1) : 

z< space > 

display i more lines, (or another screenful if no argument is given). 

"D display 11 more lines (a "scroll"). If i is given, then the scroll size is set to i. 
d same as "D (control-D). 

iz same as typing a space except that «, if present, becomes the new window size, 

zs skip i lines and print a screenful of lines. 

if skip i screenfuls and print a screenful of lines, 
q or Q Exit from more. 

= Display the current line number. 

V Start up the editor vi at the current line, 

h Help command; give a description of all the more commands. 

z/expr search for the z-th occurrence of the regular expression expr. If there are less than i 

occurrences of expr., and the input is a file (rather than a pipe), then the position in the 

file remains unchanged. Otherwise, a screenful is displayed, starting two lines before the 
place where the expression was found. The user’s erase and kill characters may be used 
to edit the regular expression. Erasing back past the first column cancels the search com¬ 
mand. 

zn search for the z-th occurrence of the last regular expression entered. 

(single quote) Go to the point from which the last search started. If no search has been 
performed in the current file, this command goes back to the beginning of the file. 

.'command 

invoke a shell with command. The characters "%" and "!" in "command" are replaced 
with the current file name and the previous shell command respectively. If there is no 
current file name, "%" is not expanded. The sequences "\%" and "\!" are replaced by 
"%" and "!" respectively. 

z:n skip to the z-th next file given in the command line (skips to last file if n doesn’t make 
sense). 

z:p skip to the z-th previous file given in the command line. If this command is given in the 
middle of printing out a file, then more goes back to the beginning of the file. If z doesn’t 
make sense, more skips back to the first file. If more is not reading from a file, the bell is 
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rung and nothing else happens. 

:f display the current file name and line number. 

:q or :Q 

exit from more (same as q or Q). 

(dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not necessary to type a carriage return. Up to 
the time when the command character itself is given, the user may hit the line kill character to 
cancel the numerical argument being formed. In addition, the user may hit the erase character to 
redisplay the - -More- -(xx%). 

At any time when output is being sent to the terminal, the user can hit the quit key (normally 
control-\). More will stop sending output, and will display the usual --More-- prompt. The 
user may then enter one of the above commands in the normal manner. Unfortunately, some out¬ 
put is lost when this is done, due to the fact that any characters waiting in the terminal’s output 
queue are flushed when the quit signal occurs. 

The terminal is set to noecho mode by this program so that the output can be continuous. What 
you type will thus not show on your terminal, except for the / and ! commands. 

If the standard output is not a teletype, then more acts just like cat, except that a header is 
printed before each file (if there is more than one). 

A sample usage of more in previewing nroff output would be 
nr off -ms -\-2 doc.n I more -s 

FILES 

/usr/lib/terminfo/?/* terminfo data base 

/usr/lib/more.help help file 

VARIABLES 

MORE Default paging mode. 

SEE ALSO 

csh(l), man(l), msgs(l), sh(l), terminfo(5), environ(5). 

BUGS 

Core will be dumped if more is invoked withtout TERM in the environment. 

When invoked from a shell such that stderr is write-only, and if stderr is interactive (e.g., 
2>fname), then input to stderr must be redirected in one of the following ways: 

2<<^0 

2</dev/tty 
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NAME 

mt - magnetic tape manipulating program 

SYNOPSIS 

mt [ -t tapename ] command [ count ] 

HP-UX COMPATABILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

DESCRIPTION 

Mt is used to give commands to the tape drive. If tapename is not specified, /dev/mt/Omn is 


used. If count is not specified, 1 is assumed. 

Here are the commands: 

eof 

write count end-of-file marks 

fsf 

space forward count files 

fsr 

space forward count records 

bsf 

space backward count files 

bsr 

space backward count records 

rew 

rewind tape 

offl 

rewind tape and go offline. 


EXAMPLE 

The following command will rewind the default mag tape unit and take it off line: 
mt offl 

FILES 

/dev/mt/* Magnetic tape interface 

/dev/rmt/* Raw magnetic tape interface 

/dev/rmt/Omn (or whatever drive is used) must be described as a Berkeley-compatibility mode 
tape drive (without rewind) for mt to operate as expected. 

SEE ALSO 

mt(4), dd(l). 
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NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp [-] [ group ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Native Language Support: 

8-bit passwords. 

DESCRIPTION 

Newgrp changes a user’s group identification. The user remains logged in and the current direc¬ 
tory is unchanged, but calculations of access permissions to files are performed with respect to the 
new real and effective group IDs. The user is always given a new shell, replacing the current shell, 
by newgrp, regardless of whether it terminated successfully or due to an error condition (i.e., unk¬ 
nown group). 

Exported variables retain their values after invoking newgrp; however, all unexported variables 
are either reset to their default value or set to null. System variables (such as PSl, PS2, PATH, 
MAIL, and HOME), unless exported by the system or explicitly exported by the user, are reset to 
default values. For example, a user has a primary prompt string (PSl) other than $ (default) 
and has not exported PSl. After an invocation of newgrp , successful or not, their PSl will now 
be set to the default prompt string $. Note that the shell command export (see sh{l)) is the 
method to export variables so that they retain their assigned value when invoking new shells. 

With no arguments, newgrp changes the group identification back to the group specified in the 
user’s password file entry. 

If the first argument to newgrp is a -, the environment is changed to what would be expected if 
the user actually logged in again. 

A password is demanded if the group has a password and the user does not, or if the group has a 
password and the user is not listed in /etc/group as being a member of that group. 

FILES 

/etc/group system’s group file 

/etc/passwd system’s password file 

SEE ALSO 

login(l), sh(l), group(5), passwd(5), environ(7). 

DIAGNOSTICS 

Sorry: 

Unknown group: 

Permission denied 

You have no shell 

BUGS 

There is no convenient way to enter a password into /etc/group. 

Use of group passwords is not encouraged, because, by their very nature, they encourage poor 
security practices. Group passwords may disappear in the future. 

Shell variables which are not exported are lost. 


You didn’t qualify as a group member. 

The group name was not in /etc/group. 

If a password must be given, it can only come from a teletype port. If the 
stdin is a non-tty file, this message is given. 

Exec of the shell failed. 
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NAME 

news - print news items 

SYNOPSIS 

news [ -a ] [ -n ] [ -s ] [ items ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

News is used to keep the user informed of current events. By convention, these events are 
described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all current files in /usr/news, 
most recent first, with each preceded by an appropriate header. News stores the “currency” time 
as the modification date of a file named .news_time in the user’s home directory (the identity of 
this directory is determined by the environment variable $HOME); only files more recent than 
this currency time are considered “current.” 

The following options can be used with news: 

-a causes news to print all items, regardless of currency. In this case, the stored time is not 
changed. 

-n causes news to report the names of the current items without printing their contents, and 
without changing the stored time. 

-s causes news to report how many current items exist, without printing their names or con¬ 
tents, and without changing the stored time. It is useful to include such an invocation of 
news in one’s .profile file, or in the system’s /etc/profile. 

Note that only one of the -a, -n, and -s options can be used at a time. 

All other arguments are assumed to be specific news items that are to be printed. 

If an interrupt is typed during the printing of a news item, printing stops and the next item is 
started. Another delete within one second of the first causes the program to terminate. 

FILES 

/etc/profile 

/usr/news/* 

$HOME/.news_time 

SEE ALSO 

mail(l), profile(5), environ(7). 
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NAME 

nice - run a command at low priority 
SYNOPSIS 

nice [ -increment ] command [ arguments ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Nice executes command with a lower CPU scheduling priority. If the increment argument (in the 
range 1-19) is given, it is used; if not, an increment of 10 is assumed. 

The super-user may run commands with priority higher than normal by using a negative incre¬ 
ment, e.g., --10. 

SEE ALSO 

nohup(l), nice(2). 

DIAGNOSTICS 

Nice returns the exit status of the subject command. 

BUGS 

An increment larger than 19 is equivalent to 19. 


Hewlett-P ackard 


- 1 - 


July 2, 1985 



NL(1) 


NL(1) 


NAME 

nl - line numbering filter 

SYNOPSIS 

nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-Inum] [-ssep] [-wwidth] [-nformat] 
[-ddelim] file 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin; System V 

DESCRIPTION 

Nl reads lines from the named file or the standard input if no file is named and reproduces the 
lines on the standard output. Lines are numbered on the left in accordance with the command 
options in effect. 

Nl views the text it reads in terms of logical pages. Line numbering is reset at the start of each 
logical page. A logical page consists of a header, a body, and a footer section. Empty sections are 
valid. Different line numbering options are independently available for header, body, and footer 
(e.g., no numbering of header and footer lines while numbering blank lines only in the body). 

The start of logical page sections are signaled by input lines containing nothing but the following 
delimiter character(s): 

Line contents Start of 

\:\:\; header 

\:\: body 

\: footer 

Unless told otherwise, nl assumes the text being read is in a single logical page body. 

Command options may appear in any order and may be intermingled with an optional file name. 
Only one file may be named. The options are: 

-htype Specifies which logical page body lines are to be numbered. Recognized types and their 
meaning are: 

a number all lines; 

t number lines with printable text only; 

n no line numbering; 

pstring number only lines that contain the regular expression 

specified in string. 

The default type for logical page body is t (text lines numbered). 

-htype Same as -htype except for header. Default type for logical page header is n (no lines 
numbered). 

-Hype Same as -htype except for footer. Default for logical page footer is n (no lines num¬ 
bered). 

-p Do not restart numbering at logical page delimiters. 

-vstart^ Startif is the initial value used to number logical page lines. Default is 1. 

-liner Incr is the increment value used to number logical page lines. Default is 1. 

-ssep Sep is the character(s) used in separating the line number and the corresponding text 

line. Default sep is a tab. 

-wwidth Width is the number of characters to be used for the line number. Default width is 6. 
-nformat Format is the line numbering format. Recognized values are: 
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In left justified, leading zeroes suppressed; 
rn right justified, leading zeroes supressed; 

rz right justified, leading zeroes kept. 

Default format is rn (right justified). 

-Inum Num is the number of blank lines to be considered as one. For example, -12 

results in only the second adjacent blank being numbered (if the appropriate -ha, 
-ba, and/or -fa option is set). Default is 1. 

~dxx The delimiter characters specifying the start of a logical page section may be 

changed from the default characters (\:) to two user-specified characters. If only 
one character is entered, the second character remains the default character (:). 
No space should appear between the -d and the delimiter characters. To enter a 
backslash, use two backslashes. 

EXAMPLE 

The command: 

nl -vlO -ilO -d!+ filel 

will number filel starting at line number 10 with an increment of ten. The logical page delimiters 
are ! and +. 

SEE ALSO 

pr(l). 
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NAME 

nm - print name list (symbol table) of object file 

SYNOPSIS 

nm [ -gnoprsu ] [filename ...] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

Remarks: This manual page describes nm as implemented on the Series 200 computers. Refer to 
other nm(l) manual pages for information valid for other implementations. 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argument list. If an argument is 
an archive, a listing for each object file in the archive will be produced. If no file is given, the 
symbols in a.out are listed. 

Each symbol name is preceded by its value printed in a representation appropriate to the archi¬ 
tecture of the machine (blanks if undefined) and one of the letters U (undefined), A (absolute), T 
(text segment symbol), D (data segment symbol), B (bss segment symbol), R (register symbol), 
F (file symbol), or C (common symbol). If the symbol is local (non-external) the type letter is in 
lower case. The output is sorted alphabetically. 

Options are: 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output line rather than only once. This 
option can be used to make piping to grep{l) more meaningful. 

-p Don’t sort; print in symbol-table order. 

-r Sort in reverse order. 

-s Sort according to the size of the external symbol (computed from the difference between 
the value of the symbol and the value of the symbol with the next highest value). This 
difference is the value printed. This flag turns on -g and -n and turns off -u and -p. 

-u Print only undefined symbols. 

If the symbol was an align symbol, the letter L will be printed after the letter describing its type. 

SEE ALSO 

ar(l), a.out(5), ar(5). 
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NAME 

nm - print name list (symbol table) of object file 

SYNOPSIS 

nm [ -gnopru ][ file ... ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

Remarks: This manual page describes nm as implemented on the Series 500 computers. Refer to 
other nm manual pages for information valid for other implementations. 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argument list. If an argument is 
an archive, a listing for each object file in the archive will be produced, preceded by the member 
name on a separate line. If no file is given, the symbols in a. out are listed. 

Options are: 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output line rather than only once. This 
option can be used to make piping to grep{l) more meaningful. 

-p Don’t sort; print in symbol-table order. 

-r Sort in reverse order. 

-u Print only undefined symbols. 

The output from nm consists of five columns of data. The following is a portion of a typical out¬ 
put: 


X 

IDATA 

00000108 

A_iob 

X 

IDATA 

000002a0 

A_sctab 

X 

ICOMM 

00000400 0 00000440 

A_sibuf 

X 

ICOMM 

00000400 0 00000840 

A_sobuf 


UDATA 

00000c40 

Aallocs 

X 

FUNC 

EDS c04 002a8 00000003 

_cleanup 

X 

DDATA 

DR 00000098 

-ctype 

X 

FUNC 

EDS cOc 00000 00000001 

_doscan 

X 

SYSTEM 

EPP 004 OOOOe 

_exit 

X 

DDATA 

DR 00000038 

_iob 

X 

DCOMM 

00000004 OOOOOObO 

_pfile 

X 

DDATA 

DR 00000090 

_sctab 

X 

PTR 

1 00000a 000000b4 

_sibuf 

X 

PTR 

1 00000c 000000b8 

_sobuf 


FILENAME 

0000000a 

_exit.o 


FILENAME 

OOOOOOOf 

_print.o 


>From left to right, the first column specifies whether the symbol is defined (.) or undefined (U). 
The second column specifies whether the symbol is non-external (.) or external (X). The third 
column gives the linker symbol type (as defined in a.out.h and described below). The fourth 
column lists the data associated with the specified symbol type. The fifth column gives the name 
of the system call, file, variable, array, common, etc., described by that entry in the symbol table. 
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Up to four data elements are reported in the fourth column. If they are not symbolic values (such 
as ‘EDS’ or ‘DR’), then they are hexadecimal values. The number of data elements reported 
depends on the symbol type. Each symbol type has one to four parameters associated with it, 
whose values are given by the data elements in the fourth column. The symbol types and associ^ 
ated parameters are discussed below. 

The following symbol types are supported: 

ABS not currently generated; reserved for future use. 

FUNC or ENTRY specifies that the entry refers to a function or procedure call. Four numbers, 
ptr^type^ segment, offset, and stt—index, are associated. Their values are 
given in order, from left to right, by the data elements. Ptr^type consists of 
a single bit that is always cleared. It is symbolically represented by ‘EDS’. 
Ptr—type is meaningful to the linker (see ld{l)), and specifies the storage 
format of the call in the symbol table. Segment specifies the code segment 
number (a number in the range 3073 to 4095, that indicates which code seg 
ment in the user’s program space contains the desired code). Offset specifies 
the number of bytes from the beginning of the code segment where the func 
tion or procedure code begins. Stt^index is an indirect reference to the 
beginning of the function or procedure code. 

SYSTEM specifies that the entry refers to a procedure call directly into the system 

kernel. Three numbers, entry_type, segment, and stt, are associated. Their 

values are given by the data elements. Entry _ type consists of a single bit 

that is always set. Its value is symbolically represented by ‘EPP’. 
Entry^type is meaningful to the linker, and specifies the storage format of 
the call in the symbol table. Segment specifies the system code segment 
number (the number of a code segment among those set aside for system 
use; typically in the range 0 to 64). Stt is an indirect pointer to the begin¬ 
ning of the procedure code. 

LABEL specifies that the entry is the destination address for a branch instruction. 

Three numbers, ptr—type, segment, and offset, are associated. Their values 
are given by the data elements. Ptr—type consists of a single bit which is 
always cleared. Its value is symbolically represented by ‘EDS’. Ptr—type is 
meaningful to the linker, and specifies the storage format of the address in 
the symbol table. Segment specifies the user code segment number. Offset 
specifies the number of bytes from the beginning of the code segment where 
the label begins. 

DDATA specifies that the entry is a directly-addressable, initialized data structure (a 

variable, or the beginning of an array, common, structure, etc.). Two 
numbers, base—reg and displacement, are associated. Their values are given 
by the data elements. Base^reg is assigned one of nine possible symbolic 
values which describe the addressing scheme used to find the data structure. 
It is meaningful to the linker. The possible symbolic values are P+, P-, DB, 
DL, Q+, Q-, SB, S-, and DR. Displacement specifies the byte offset where 
the data structure is located. Note that this offset is measured relative to 
the beginning of the data space of the file for which the nm listing is made. 
The actual byte offset of the data structure in the executable a.out file 
could change. 

IDATA or UDATA 

specifies that the entry refers to an indirectly-addressable, uninitialized 
array, or an indirectly-addressable, initialized common block. One number, 
displacement, is associated. Its value is given by the data element. It is 
identical to the displacement described above under DDATA. 
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DCOMM or ICOMM 

specifies that the entry is treated as a common block. Three numbers, 
blocksize^ needs^length—word, and displacement^ are associated. Their 
values are given by the data elements. Blocksize is the size, in bytes, of the 

common block. Needs _ length^word is a boolean value which appears in a 

print-out as either 0 or 1. If its value is 1, the linker places the value of 
[blocksize - 4) in the first four bytes of the common block. This information 
is necessary when linking FORTRAN programs. Displacement is identical 
to that described under DDATA above. 

PTR specifies that the entry is a pointer to an indirectly-addressable data struc¬ 

ture (variable, array, common block, etc.). Three numbers, 
ptr^to—common^ target^ and address, are associated. Their values are given 
by the data elements. Ptr—to—common is an eight-bit boolean expression. 
Its value is given as 1 (true) or 0 (false). If true, then the entry is a pointer 
to a common block. If false, the entry is a pointer to some other type of 
data structure. Target is an index into the symbol table to the entry that 
describes the target of the data structure pointer. Address is a pointer to 
the data structure pointer; that is, an indirect pointer to the data structure. 

SEGMENT not currently generated; reserved for future use. 

FILENAME specifies that the entry is a file name. One number, sequence, is associated. 

Its value is given by the data element. Sequence reflects the order in which 
the linker encountered each file name. 

SEE ALSO 

ar(l), a.out(5), ar(5). 

DIAGNOSTICS 

Nm generates an error message for the following conditions: 
invalid option 
cannot open file 
bad magic number 
read error 
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NAME 

nohup - run a command immune to hangups, logouts, and quits 

SYNOPSIS 

nohup command [ arguments ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Nohup executes command with hangups and quits ignored. If output is not re-directed by the 
user, both standard output and standard error are sent to nohup.out. If nohup.out is not writ¬ 
able in the current directory, output is redirected to $HOME/nohup.out; otherwise, nohup will 
fail. 

If output from nohup is redirected to a terminal, or is not redirected at all, the output is sent to 

nohup.out. 

EXAMPLE 

It is frequently desirable to apply nohup to pipelines or lists of commands. This can be done only 
by placing pipelines and command lists in a single file, called a shell procedure. One can then 
issue: 


nohup sh file 

and the nohup applies to everything in file. If the shell procedure file is to be executed often, then 
the need to type sh can be eliminated by giving file execute permission. Add an ampersand and 
the contents of file are run in the background with interrupts also ignored (see s/i(l)): 

nohup file 

An example of what the contents of file could be is: 
tbl ofile 1 eqn I nroff > nfile 

SEE ALSO 

chmod(l), nice(l), sh(l), signal(2). 

WARNINGS 

nohup commandl; command2 nohup applies only to commandl 
nohup (commandl; command2) is syntactically incorrect. 

Be careful of where standard error is redirected. The following command may put error messages 
on tape, making it unreadable: 

nohup cpio -o <list >/dev/rmt/lm k, 

while 

nohup cpio -o <list >/dev/rmt/lm 2>errors k 
puts the error messages into file errors. 
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NAME 

nroff - format text 

SYNOPSIS 

nroff [ options ] [ files ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Nroff formats text contained in files (standard input by default) for printing on typewriter-like 
devices and line printers. Its capabilities are described in the NROFF/TROFF User’s Manual 
cited below. 

Nroff is best not used directly, but rather via macro packages such as mm or ms which provide a 
high-level interface to document processing, as opposed to the very low level one provided directly 
in nroff. 

An argument consisting of a minus (--) is taken to be a file name corresponding to the standard 
input. The options, which may appear in any order, but must appear before the files, are: 

-olist Print only pages whose page numbers appear in the list of numbers and ranges, 
separated by commas. A range N-M means pages N through M; an initial -N means 
from the beginning to page N; and a final N- means from N to the end. (See BUGS 
below.) 

-nN Number first generated page N. 

-sN Stop every N pages. Nroff will halt after every N pages (default JV=1) to allow paper 
loading or changing, and will resume upon receipt of a line-feed or new-line (new-lines 
do not work in pipelines, e.g., with mm(l)). When nroff halts between pages, an ASCII 
BEL is sent to the terminal. 

-raN Set register a (which must have a one-character name) to N. 

-i Read standard input after files are exhausted. 

-q Invoke the simultaneous input-output mode of the .rd request. 

-z Print only messages generated by .tm (terminal message) requests. 

-mname Precede the input files with the non-compacted (ASCII text) macro file 

/usr/lib/tmac / tmac . name . 

-cname Precede the input files with the compacted macro files 

/ usr/lib/macros/cmp. [nt] . [dt]. name and / usr/lib/macros/ucmp. [nt] . name . 
-kname Compact the macros used in this invocation of nroff, placing the output in files 

[dtj.name in the current directory (see the May 1979 Addendum to the 

NROFF/TROFF User’s Manual for details of compacting macro files). 

-Tname Prepare output for specified terminal. Known names are 37 for the (default) TELE¬ 
TYPE Model 37 terminal, tnSOO for the GE TermiNet 300 (or any terminal without 
half-line capability), 300s for the DASI 300s, 300 for the DASI 300, 450 for the DASI 
450, Ip for a (generic) ASCII line printer, 382 for the DTC-382, 4000A for the Trendata 
4000A, 832 for the Anderson Jacobson 832, X for a (generic) EBCDIC printer, and 
2631 for the Hewlett Packard 2631 line printer. 

-e Produce equally-spaced words in adjusted lines, using the full resolution of the particu¬ 

lar terminal. 

-h Use output tabs during horizontal spacing to speed output and reduce output character 

count. Tab settings are assumed to be every 8 nominal character widths. 

-un Set the emboldening factor (number of character overstrikes) for the third font position 
(bold) to n, or to zero if n is missing. 

HP UX nroff differs from other versions of nroff as follows: 

1) New facilities for handling of the revision bar (,mc) feature are provided: 
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The read/write number register ic holds the revision bar character (as an ordinal) that will 
be printed on the current line, if any. The number registers .m and .e contain respecitvely 
the revision bar character and offset as set by the .me command, and are read only. These 
make it possible to deal with the revision bar information in a macro, thus making it possible 
for the printed result to properly reflect the revision information in the source. 

2) The date and time used are the appropriate local time. 

Series 500: 

The -c and -k options are not currently supported. 


FILES 

/usr/lib/suftab 

/tmp/ta$# 

/ usr/lib/tmac/tmac. * 
/usr/lib/macros / ♦ 
/usr/lib/term/* 


suffix hyphenation tables 
temporary file 

standard macro files and pointers 

standard macro files 

terminal driving tables for nro^ 


SEE ALSO 

mm(l). 

NROFF/TROFF User’s Manual in HP-UX: Selected Articles. 

BUGS 

Nr off is keyed to Eastern Standard Time; as a result, depending on the time of the year and on 
your local time zone, the date that nr off generates may be off by one day from your current date. 
When nroff is used with the -olist option inside a pipeline, it may cause a harmless "broken pipe" 
diagnostic if the last page of the document is not specified in list. 
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NAME 

od, xd - octal and hexadecimal dump 
SYNOPSIS 

od [ -bcdox ] [ file ] [ [ + ]offset[ • ][ b ] ] 
xd [ -bcdox ] [ file ] [ [ + ]offset[ . ][ b ] ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III and HP 

DESCRIPTION 

Od {xd) dumps file in one or more formats as selected by the first argument. If the first argu¬ 
ment is missing, -o (-x) is the default. Each line is prepended with an offset field. For od, the 
offset is in octal, for xd the offset is in hexadecimal. The meanings of the format options are: 


-b 

Interpret bytes in octal (hexadecimal). 


-c 

Interpret bytes in ASCII. Certain non-graphic characters appear as C escapes: 
backspace=\b, form-feed=\f, new-line=\n, return=\r, tab=\t; others appear 
octal numbers. 

null=\0, 
as 3-digit 

-d 

Interpret 16-bit words in decimal. 


-o 

Interpret 16-bit words in octal. 


-X 

Interpret 16-bit words in hexadecimal. 



The file argument specifies which file is to be dumped. If no file argument is specified, the stan¬ 
dard input is used. 

The offset argument specifies the offset in the file where dumping is to commence. This argument 
is normally interpreted as octal bytes. If . is appended, offset is interpreted in decimal. If Ox is 
prepended, offset is interpreted in hexadecimal. If b is appended, offset is interpreted in blocks of 
512 bytes. If the file argument is omitted, offset must be preceded by -f. 

Dumping continues until end-of-file. 

SEE ALSO 

adb(l). 
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NAME 

pack, peat, unpack - compress and expand files 

SYNOPSIS 

pack [ - 1 [ -f ] name ... 
peat name ... 
unpack name ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Pack attempts to store the specified files in a compressed form. Wherever possible (and useful), 
each input file name is replaced by a packed file name.z with the same access modes, access and 
modified dates, and owner as those of name. The -f option will force packing of name. This is 
useful for causing an entire directory to be packed even if some of the files will not benefit. If 
pack is successful, name will be removed. Packed files can be restored to their original form using 
unpack or peat. 

Pack uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If the - argument is 
used, an internal flag is set that causes the number of times each byte is used, its relative fre¬ 
quency, and the code for the byte to be printed on the standard output. Additional occurrences 
of - in place of name will cause the internal flag to be set and reset. 

The amount of compression obtained depends on the size of the input file and the character fre¬ 
quency distribution. Because a decoding tree forms the first part of each .z file, it is usually not 
worthwhile to pack files smaller than three blocks, unless the character frequency distribution is 
very skewed, which may occur with printer plots or pictures. 

Typically, text files are reduced to 60-75% of their original size. Load modules, which use a larger 
character set and have a more uniform distribution of characters, show little compression, the 
packed versions being about 90% of the original size. 

Pack returns a value that is the number of files that it failed to compress. 

No packing will occur if: 

the file appears to be already packed; 
the file is all nulls; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 

a file called name.z already exists; 

the .z file cannot be created; 

an I/O error occurred during processing. 

The last segment of the file name must contain no more than 12 characters to allow space for the 
appended .z extension. Directories cannot be compressed. 

Peat does for packed files what cat{l) does for ordinary files, except that peat can not be used as 
a filter. The specified files are unpacked and written to the standard output. Thus to view a 
packed file named name.z use: 

peat name.z 
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or just: 

peat name 

To make an unpacked copy, say nnn, of a packed file named name.z (without destroying name.z) 
use the command: 

peat name >nnn 

Peat returns the number of files it was unable to unpack. Failure may occur if: 

the file name (exclusive of the .z) has more than 12 characters; 
the file cannot be opened; 

the file does not appear to be the output of pack. 

Unpack expands files created by pack. For each file name specified in the command, a search is 
made for a file called name.z (or just name., if name ends in .z). If this file appears to be a 
packed file, it is replaced by its expanded version. The new file has the .z suffix stripped from its 
name, and has the same access modes, access and modification dates, and owner as those of the 
packed file. 

Unpack returns a value that is the number of files it was unable to unpack. Failure may occur for 
the same reasons that it may in peat, as well as for the following: 

a file with the “unpacked” name already exists; 
if the unpacked file cannot be created. 

SEE ALSO 

cat(l). 
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NAME 

pam Personal Applications Manager, a visual shell 

SYNOPSIS 

pam [ -c args ... ] 

HP-UX COMPATIBILITY 

Level: NON-STANDARD 

Origin: HP 
DESCRIPTION 

Pam is a program that helps provide a friendlier, less intimidating means of communication 
between HP-UX and system users. It provides many of the traditional capabilities supported by 
other shell programs such as executing commands as foreground processes (where you must wait 
until one command has been completed before the system accepts the next command) or back¬ 
ground processes (where the command runs in the background while you perform other tasks in 
the foreground). Pam also sxipports other useful capabilities such as using substituted files instead 
of standard input and standard output, pipelining several processes into a single command, and 
handling shell scripts and programs. Pam maintains a continuous display of the open folder 
(current directory), and makes use of windowing and mouse I/O facilities when they are available 
on the system. 

Display 

The pam display has two parts. The top two lines are called the command area, while the 
remainder of the display is the folder (directory) area. The first line in the command area 
displays messages (such as prompts and errors) from the system to the user, while the second 
line displays input commands and text from the user to the system. Pam maintains a buffer 
of 20 command lines. You can use shifted arrow keys, BACK SPACE, INSERT CHARACTER, and 
DELETE CHARACTER to access and edit any existing current or previous command line in the 
20-line command buffer. For example, each time you press SHIFT-UP ARROW, the next previ¬ 
ous command line in the buffer is displayed. 

The folder (lower) area is used by pam to display those files that reside in the currently open 
folder; that is, the current directory. One of the file names displayed in the folder area is 
highlighted. This highlighted filename identifies which file in the folder is to be used as a 
filename parameter for pam commands that are invoked using the pam menu. The highlighted 
file name can be changed by using TAB, SHIFT-TAB and arrow keys. 

Commands 

A command is a sequence of non-blank words separated by blanks. In general, the first word 
is the name of the command, and the words that follow are passed as arguments to the 
invoked command. Two or more commands (together with their associated arguments, if any) 
separated by a vertical bar ( | ) form a pipeline. To provide a path for passing data between 
commands in a pipeline, the standard output from one command in the pipeline is connected 
to the standard input of the next command in the pipe. 

To force pam to complete execution of the current command or pipeline before running 
another command, place a semicolon (;) at the end of the line. If you prefer to perform other 
tasks while the command or pipeline is being executed, run the first command as a "back¬ 
ground" process by adding an ampersand (&) at the end of the command line. Pam then 
starts the command, and, without waiting for completion, returns for your next instruction. 

In a windowed system, interactive command inputs are treated as background processes (&) 
unless a semicolon is present at the end of the line. In non-windowed systems, commands 
taken from a script or from interactive command inputs are run to completion before the next 
command is accepted for execution (;) unless an ampersand is present at the end of the com¬ 
mand line. 
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Sequences of more than one command or pipeline can be joined on a single command line by 
placing a semicolon or ampersand (but not both) between each adjacent pair of 
commands/pipelines in the line. In such constructs, commands separated by are executed 
in sequence (the first command is run to completion before the next is begun). Commands 
separated by are executed simultaneously on a timesharing basis (this does not necessarily 
result in the most efficient use of computer resources due to timesharing overhead as sharing 
processes compete for processor time). Note that when or "k" is used to separate com¬ 
mands, standard output from one command is not automatically connected to standard input 
for the next. Use the pipeline connector (| ) instead when data must be passed between suc¬ 
cessive commands or programs, or redirect standard output and input to and from a specified 
file. 

Pam runs commands based on the file type of the command name: 

program (executable) - The conunand name is run (exec’ed) or, if it is a shell script, 
the commands in the script are run. 

folder (directory) - The command name (folder) becomes the new open folder. 

This is equivalent to cd folder. 

data (non-executable) - The command name (data file) is displayed one page at a 
time. 

Standard Input, Output, and Error Files 

The standard input, output and error of a command can be redirected using the following syn¬ 
tax: 


< name Use the file name as standard input for the command. 

> name Use the file name as standard output for the command. 

>> name Use the file name as standard output for the command, but concatenate 
the output to the end of the file. 

name Use the file name as standard error for the command. 

name Use the file name as standard error for the command, but concatenate the 
output to the current end of the file, if it exists. 

# name [For windowed systems only] Use the named window as standard input, 
output and error for the command. If the window doesn’t exist then a 
window is created. Specific redirection of I/O with >, >>, <, 1, ", or "" 
overrides any redirection specified with 

I/O redirection is possible only with an associated command. Multiple redirections of standard 
input, output, and error associated with a command are not allowed. The I/O redirection can 
be placed anywhere in the command. 


If a command is followed by "k" (background process), the default standard input for the 
command is the empty file "/dev/null". 


Using Patterns to Represent Filenames 

Each word in the command line (command name, parameter, redirection file name, window 
name) is scanned for the characters *, ?, and [. If one of these characters appears, the word is 
treated as a pattern that represents more than one filename. Pam replaces the pattern word 
with alphabetically sorted filenames corresponding to the pattern. If no file name is found that 
matches the pattern, the word is left unchanged. A period character (.) at the start of a 
filename or immediately following a /, as well as the character / itself, must be matched expli¬ 
citly. 


Matches any string, including the null string. 
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? Matches any single character. 

[...] Matches any one of the enclosed characters. A pair of characters separated by - 
matches any character lexically between the pair, inclusive. A NOT operator, !, 
can be specified immediately following the left bracket to match any single char¬ 
acter not enclosed in the brackets. 

Quoting 

Characters can be quoted on the pam command line to prevent pam from performing special 
processing on the characters (such as <, >, #, space, A pair of double ( " ) or 

single (’) quote characters can be used to enclose the character string being quoted. The \ 
character quotes only the single following character. 

Scripts 

A script is an executable file containing command lines and comments. A comment is a line 
that begins with "!" or comments are ignored by pam. The command lines in the script 
file are executed in sequence (unless non-sequential execution is explicitely specified using the 
character). 

Script arguments that are specified when a script is run can be accessed by script commands 
using the notation "$1" for the first argument, "$2" for the second argument, etc. All argu¬ 
ments can be accessed at once using The name of the script can be accessed using "$0". 

Autost 

If a file named Autost exists in the open folder when pam is started, it is automatically pro¬ 
cessed as a command. If Autost is a script file, it is run as source Autost (see Built-In Com¬ 
mands described later). Otherwise, it is processed as if it were entered as a command (for 
example, if Autost is a data file, it is viewed). Pam does not process any command input until 
processing of the Autost file is complete. 

Environment 

The pam environment is set up when pam is run, and can be reset at any time by using the 
command getenv. The environment variables are read from a file and are not sorted or 
checked for syntax by pam. Pam passes the current environment to commands that it starts 
and uses the following environment variables in running commands: 

ACTION The ACTION variable specifies a command name (corresponding to 

an executable file), and is used whenever a data file is specified as a 
command. The ACTION command is run in this case and the data 
file is passed as the first argument. The default value for ACTION is 
"view". 

The HOME variable specifies a folder and is used whenever the "cd" 
command is run without an argument. The HOME folder specifies 
the directory to change to in this case. The default value for HOME 
is 7". 

The LANG variable is added by pam to its environment file if it is not 
already there. This happens when pam is initialized or when the 
getenv command is done. The value of the LANG variable is set to 
match the language that the system is localized for. 

The PATH variable specifies a list of folders. When pam runs a com¬ 
mand it looks for it in the folders in the PATH list. 

SCRSHELL The SCRSHELL variable specifies the shell to be used by pam in run¬ 
ning scripts. If the specified name does not contain a "/" then pam 
searches for the shell using the PATH environment variable. If the 
SCRSHELL is undefined or the specified shell does not exist, the script 


HOME 


LANG 


PATH 
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is processed by pam. 

Menu 

The pam menu displays the following softkey menu labels corresponding to the indicated func¬ 
tion keys: 

[function key 1] open, view, or start (a program), or reread 
[f2] echo 

[f3] send or arrow (toggle key) 

[f4j move 
[f5j copy 
[f6] rename 
[f7] delete 
[f8] close 

The command associated with a menu item is run whenever the item is selected by pressing 
the corresponding function key. The highlighted file name in the folder area of the display is 
used as a parameter for the command. 

The menu item associated with f3 is used to toggle the semantics of the arrow keys and is 
available only in non-windowed systems. f3 is initially set to use the arrow keys for manipu¬ 
lating the position of the file highlight in the folder area. f3 alternately controls movement of 
the cursor on the command line. 

Built-In Commands 


Several commands are executed directly by pam: 

cd [name] Make the named folder (directory) the open folder 

(current directory). If no folder is specified, the HOME 
environment variable is used to determine which folder to 
open. 

Closes the open folder and displays the parent folder. 

] folder—.name 

Copy namel to name2\ if exists and is not a folder, it is 
overwritten. If only namel is specified, the copy is com¬ 
pleted with the command ioname2. If the last parameter 
specified is a folder, all the specified files are copied into 
that folder. 

The named files and folders (if empty) are deleted. 

Arguments are written to standard output. The echo 
menu item (menu item 2 and/or function key 2) writes 
the full pathname of the highlighted file in the folder area 
of the display to the command line. 

getenv name The named file is read in and used as the active environ¬ 

ment. 

makefolder namel [name2 ...] 

Folders are created and given the specified name(s). 

move namel [name2] 
move namel [name2] folder^name 

Rename file or folder namel to name2. If name2 exists 
and is a file, it is overwritten. If only namel is specified, 
use the command to name2 to complete the move. If the 
last parameter is a folder, all the specified files are moved 


delete namel [name2 ...] 
echo [arg ...] 


close 

cojpynamel [name2] 
copy namel [name2 ... 
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into that folder. 

netunam pathname [string] 

Initiate a network connection to the specified system (as 
indicated by pathname) using the specified login (as indi¬ 
cated by string). If string is omitted, the network connec¬ 
tion to the specified system, if currently active, is discon¬ 
nected. 

print namel [name2 ...] Print the specified files on the designated system printer, 
rename namel [name2] 

rename file—namel [file—name2 ...] folder—name 
Same as move. 

reread Reread the open folder and update the display. The keys¬ 

troke CONTROL-L also does a reread. 

Send the full pathname of the highlighted filename in the 
folder area to an application as if it were typed from the 
keyboard (windowed systems only). 

Read command lines from the named script file and exe¬ 
cute them. A shell is NOT forked to execute the com¬ 
mands. Parameter substitution for the arguments {arg 
...) is handled the same way as during regular script exe¬ 
cution. 

stopprint Stop current printing activity if it was started by the 

print command. 

to [name] Complete a pending copy, move or rename. The file or 

folder name identifies the destination for a preceding 
copy, move, or rename command that had no destina¬ 
tion specified. If name is omitted, the destination defaults 
to the current open folder. 

view namel [name2 ...] Copy the specified file(s) to standard output. If standard 
output is the screen (default), the file is displayed one 
page at a time. 

Signals 

Pam ignores INTERRUPT and QUIT signals if the command is followed by an other¬ 
wise pam uses default signal handling when running commands. 

Invoking Pam 

Pam can be invoked as a keyboard command or from a program. When pam is invoked 
without -c as the first argument, pam acts as an interactive, display-oriented command 
interpreter. 

When pam is invoked with -c as the first argument (either from the keyboard or from a 
running program), the remaining arguments in the command are interpreted as command 
inputs intended for processing by pam. The list of arguments intended as commands for 
pam must not exceed a total of 160 characters. When the -c option is used, pam executes 
the list of command arguments (built-in commands, redirection, pipes, and most other pam 
facilities can be used), then exits. 

Exiting from Pam 

To terminate pam and return to normal HP-UX operation, press CONTROL-D or 
CONTROL-C. 
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HARDWARE DEPENDENCIES 

With a non-windowed pam running on certain terminals the shifted right and left arrow keys can¬ 
not be used to move the cursor on the command line. 


IPC: pam runs commands with the SIGHUP signal ignored. 

The netunam built-in command is not supported. 

Series 300/500: The built-in commands print, stopprint, and send are not supported. 
The environment variable LANG is not set up by pam. 


FILES 

/rom/PAM 
/rom/. environ 
/tmp/Plock 
Autost 

/rom/PAMmsg 

/usr/lib/nls/n-computer / pam. cat 
/dev/null 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd [ name ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Native Language Support: 

8-bit passwords. 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

This command changes or installs a password associated with the login name. If name is omitted, 
it defaults to getlogin[Z) name. 

Ordinary users may change only the password which corresponds to their login name. 

Passwd prompts ordinary users for their old password, if any. It then prompts for the new pass¬ 
word twice. The first time the new password is entered passwd checks to see if the old password 
has “aged” sufficiently. If “aging” is insufficient the new password is rejected and passwd ter¬ 
minates; see passwd(4). 

Assuming “aging” is sufficient, a check is made to insure that the new password meets construc¬ 
tion requirements. When the new password is entered a second time the two copies of the new 
password are compared. If the two copies are not identical the cycle of prompting for the new 
password is repeated for at most two more times. 

Passwords must be constructed to meet the following requirements: 

Each password must have at least six characters. Only the first eight characters are 
significant. 

Each password must contain at least two alphabetic characters and at least one numeric 
or special character. In this case, “alphabetic” means upper and lower case letters. 

Each password must differ from the user’s login name and any reverse or circular shift of 
that login name. For comparison purposes, an upper case letter and its corresponding 
lower case letter are equivalent. 

New passwords must differ from the old by at least three characters. For comparison 
purposes, an upper case letter and its corresponding lower case letter are equivalent. 

One whose effective user ID is zero is called a super-user; see zd(l), and su{l). Super-users may 
change any password; hence, passwd does not prompt super-users for the old password. Super- 
users are not forced to comply with password aging and password construction requirements. A 
super-user can create a null password by entering a carriage return in response to the prompt for 
a new password. 

FILES 

/etc/passwd 

SEE ALSO 

login(l), id(l), su(l), crypt(3C), passwd(5). 

DIAGNOSTICS 

Permission denied. 

name is not in password file, or you are not user name or the super-user. 

Sorry, the old password does not match. 
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Sorry: <x weeks since the last change 

password aging is in effect, and it is too soon to change yours. 

You may not change this password 

the super-user has made it impossible to change your password. 

Too short 

passwords must be at least 4 characters long. 

Please use at least one non-numeric character 

your new password does not utilize a sufficiently varied selection of characters. You can 
override this rule by re-entering your new password 2 more times. 

Please use a longer password. 

your new password is not long enough to be sufficiently secure. You can override this rule 
by re-entering your new password 2 more times. 

They don’t match, try again. 

the two entries of your new password are not identical. 

Temporary file busy; try again later 

only one user can change his password at a time. 

Cannot create temporary file 
see the super-user. 

Cannot unlink ’filename’ 
see the super-user. 

cannot link ’file ’ to ’file ’. 

see the super-user. 

cannot recover ’file’. 

see the super-user. 

Password unchanged. 

the new and old passwords are the same. 
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NAME 

paste - merge same lines of several files or subsequent lines of one file 

SYNOPSIS 

paste filel file2 ... 
paste -dlist filel file2 ... 
paste -s [-dlist] filel file2 ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the given input files filel, file2, 
etc. It treats each file as a column or columns of a table and pastes them together horizontally 
(parallel merging). If you will, it is the counterpart of cat{l) which concatenates vertically, i.e., 
one file after the other. In the last form above, paste replaces the function of an older command 
with the same name by combining subsequent lines of the input file (serial merging). In all cases, 
lines are glued together with the tab character, or with characters from an optionally specified list. 
Output is to the standard output, so it can be used as the start of a pipe, or as a filter, if - is used 
in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each but the last file (or last line in case 
of the -s option) are replaced by a tab character. This option allows replacing the tab 
character by one or more alternate characters (see below). 

list One or more characters immediately following -d replace the default tab as the line con¬ 
catenation character. The list is used circularly, i.e., when exhausted, it is reused. In 
parallel merging (i.e., no -s option), the lines from the last file are always terminated with 
a new-line character, not from the list. The list may contain the special escape 
sequences: \n (new-line), \t (tab), \\ (backslash), and \0 (empty string, not a null 
character). Quoting may be necessary, if characters have special meaning to the shell 
(e.g., to get one backslash, use -d"\\\\" ). 

-s Merge subsequent lines rather than one from each input file. Use tab for concatenation, 
unless a list is specified with -d option. Regardless of the list, the very last character of 
the file is forced to be a new-line. 

May be used in place of any file name, to read a line from the standard input. (There is 
no prompting). 

EXAMPLES 

Is I paste -d" " - 

Is I paste- 

paste -s -d"\t\n" file 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr -t -m. .. works similarly, but creates extra blanks, tabs and new-lines for a nice page 
layout. 

DIAGNOSTICS 

line too long Output lines are restricted to 511 characters. 

too many files Except for -s option, no more than 12 input files may be 

specified. 


list directory in one column 
list directory in four columns 
combine pairs of lines into lines 
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NAME 

pc - Pascal compiler 

SYNOPSIS 

pc [ options ] files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Native Language Support: 

8-bit and 16-bit characters in strings and comments. 

Remarks: This manual page describes the generic HP Pascal compiler; implementation depen¬ 
dencies for different machines are noted as needed. Currently the Series 300 and Series 
500 computers support HP Pascal under HP-UX, as described in this document. 

DESCRIPTION 

Pc is the HP standard Pascal compiler. It accepts several types of file arguments: 

(1) Arguments whose names end with .p are taken to be Pascal source files. They are each 
compiled, and each corresponding archived object program or module(s) is left in the current 
directory in a file whose name is that of the source, with .a substituted for .p. Note that 
the Series 500 does not produce archived object (.a) files, instead it produces simple object 
(.o) files (where the .p is replaced with .o). The .a (or .o) file will not be created if only a 
single source is compiled and linked, if the -C option is specified, or if the source fails to 
compile correctly. 

(2) All other file arguments, including those whose names end with .o or .a are passed on to the 
linker (/d(l)) to be linked into the final program. 

Arguments can be passed to the compiler through the PCOPTS environment variable as well as 
on the command line. The compiler picks up the value of PCOPTS and places its contents before 
any arguments on the command line. For example (in sh{l) notation), 

$ PCOPTS=-v 
$ export PCOPTS 
$ pc -L prog.p 

is equivalent to 

$ pc -V -L prog.p 

The following options are recognized: 

-A Produce warnings for the use of non ANSI-Pascal features, (same as $ANSI ON$). 

-C Suppress code generation - no .a (or .o) files will be created and linking will be 

suppressed. This is effectively a request for syntax/semantic checking only (same as 

$CODE OFFS). 

-c Suppress linking and only produce object (.a or .o) files from source files. 

-g Generate additional information needed by the Pascal Symbolic Debugger (pdb), 

and ensure that the program is linked as required by pdb. See the appropriate 
implementation reference manual for more information on symbolic debugging sup¬ 
port. 

-L Write a program listing to stdout (or for the Series 300 only, to the file given in the 

SLIST filenames option in the source). 

-lx Cause the linker to search the library named either /lib/liba;.a (tried first) or 

/usr/lib/liba:.a. (See ld{l).) 
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Cause the output file from the linker to be marked as unshareable (see -n). For 
details and system defaults, refer to the linker documentation {ld{l)). 

Cause the output file from the linker to be marked as shareable (see -N). For details 
and system defaults, refer to the linker documentation (/d(l)). 

Name the output file from the linker outfile instead of a. out. 

Specifies the number of lines (including any header or trailer) which should be listed 
per page of generated listing (same as SLINES n$). 

Cause the output file from the linker to be marked as not demand loadable (see -q). 
For details and system defaults, refer to the linker documentation 

Cause the output file from the linker to be marked as demand loadable (see -Q). For 
details and system defaults, refer to the linker documentation {ld{l)). 

Cause the output of the linker to be stripped of symbol table information (see ld(l) 
and strip(l)). (This option is incompatible with symbolic debugging). 

Substitute or insert subprocess c with name where c is one or more of a set of 
identifiers indicating the subprocess(es). This option works in two modes: 1) if c is a 
single identifier, name represents the full path name of the new subprocess; 2) if c is 
a set of (more than one) identifiers, name represents a prefix to which the standard 
suffixes are concatenated to construct the full path name of the new subprocesses. 

The values c can take on are: 

c compiler body (standard suffix is pascomp) 

0 same as c 

I linker (standard suffix is Id) 

-V Enable verbose mode, producing a step-by-step description of the compilation pro¬ 

cess on stderr. 

-w Suppress warning messages (same as $WARN OFF$); 

-W c, argl [, arg2,argN] 

Cause argl through argN to be handed off to subprocess c. The argi are of the form 
-argoption[,argvalue], where argoption is the name of an option recognized by the 
subprocess and argvalue is a separate argument to argoption where necessary. The 
values that c can assume are those listed under the -t option, as well as the value d 
(driver program) which has a special meaning explained below. 

For example, the specification to pass the -r (preserve relocation information) option 
to the linker would be: 

-W 1,-r 

The -W d option specification allows additional, implementation-specific options to 
be recognized and passed through the compiler driver to the appropriate compiler 
subprocesses. For example, 

-W d,-U (Series 500) 

will send the option -U to the driver and compiler. Furthermore, a shorthand nota¬ 
tion for this mechanism can be used by prepending + to the option name; as in 

4-U 


-N 

-n 

-o outfile 
-P lines 

-Q 

-q 

-s 

-t c,name 
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which is equivalent to the previous option expression. Note that for simplicity this 
shorthand is applied to each implementation-specific option individually, and that 
the argvalue is no longer separated from the argoption by a comma (see -W). 

-Y Enable 16-bit Native Language Support when parsing string literals and comments 

(same as $HP16 ON$). Note that 8-bit parsing is always supported. 

The implementation-specific options on the Series 500 are: 


-fE Cause the program to be linked with the library /lib/libpcesc.a which transforms 

all execution errors (HP-UX signals, Pascal run-time errors, Pascal I/O errors and 
HP-UX errors) into escapes. This differs from the default library /lib/libpccat.a 
which prints the appropriate error message and aborts the program. 

4-F Cause the compiler to generate information which is used by various program 

analyzers. 

-fH [bytes] Display (if bytes is omitted) or set a Pascal program’s maximum heap size. Bytes is 
the maximum number of bytes in the heap. 


+Q dfile Cause dfile to be read before compilation of each source file. Dfile may only contain 
compiler options. 


-|-U Cause the compiler to upshift externally visible names, default is lower case (same as 

$UPSHIFT_LEVEL1 ON$). 

-f W [bytes] Display (if bytes is omitted) or set a Pascal program’s working set size. Bytes is the 
number of bytes in the program’s working set; 


FILES 

file.p 
file.a 

file.o 

a.out 
/bin/pc 

/ usr/lib/pascomp 

/usr/lib/paserrs 

/usr/lib/escerrs 

/usr/lib/syserrs 

/usr/lib/ioerrs 

/lib/crtO.o 

/lib/prtO.o 

/lib/libpc.a 

/lib/libm.a 

/lib/libpccat.a 

/lib/libpcesc.a 

/usr/tmp/* 


input file (Pascal source file) 

generated object archive file (except for the Series 500) or any archive file to 
be searched at link time 

object file to be relocated at link time (or generated object file for the Series 
500 only) 

linked executable output file 
compiler and linker driver program 
compiler 

compiler error message file 
Pascal escape codes (Series 300 only) 

HP-UX system messages (Series 300 only) 

Pascal I/O results (Series 300 only) 
runtime startup (Series 300 only) 
runtime startup (Series 500 only) 

Pascal run-time library 

HP-UX math library (Series 300 only) 

Pascal run-time library, reports errors and aborts program (Series 500 only) 
Pascal run-time library, translates errors into escapes (Series 500 only) 
temporary files used by the compiler; names are created by tmpnam{3S),. 


SEE ALSO 

HP Pascal Language Reference, HP Part No. 98680-90015 (Series 300). 

Pascal/9000 Language Reference Manual, HP Part No. 97082-90001 (Series 500). 
Programming in Pascal with Hewlett-Packard Pascal, by Peter Grogono (Series 300/500). 


DIAGNOSTICS 

The diagnostics produced by pc are intended to be self-explanatory. Occasional messages may be 
produced by the linker. 

A list of all compiler errors may be found in /usr/lib/paserrs. 
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If a listing is requested (-L option), errors are written to the listing file (stdout). If a listing is 
requested and either or both of stdout/stderr has been redirected to something other than a ter¬ 
minal, errors will also be written to stderr. If no listing is requested (no -L option), errors are 
written to stderr. This effectively guarantees that stderr will always recieve error messages, unless 
that would result in duplication of error messages printed on the terminal. 

HARDWARE DEPENDENCIES 

Series 500: 

The following options are no longer supported: -b, -e, and -f. 

The following options must now be specified with the -W d,.** option or the -f shorthand: -E, 
-F, -H [bytes], and - W [bytes]. 

To use the +H or +W options on an executable file other than a.out, the file to be examined 
(modified) must be specified with the -o option. To set the heap of program foo to 1000000 

use: 

pc +H 1000000 -0 foo 
do not use: 

pc +H 1000000 -W l,-o,foo 
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NAME 

pr - print files 

SYNOPSIS 

pr [ options ] [ files ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages. 

DESCRIPTION 

Pr prints the named files on the standard output. If file is -, or if no files are specified, the stan¬ 
dard input is assumed. By default, the listing is separated into pages, each headed by the page 
number, a date and time, and the name of the file. 

By default, columns are of equal width, separated by at least one space; lines which do not fit are 
truncated. If the -s option is used, lines are not truncated and columns are separated by the 
separation character. 

If the standard output is associated with a terminal, error messages are withheld until pr has 
completed printing. 

The below options may appear singly or be combined in any order: 

-\-k Begin printing with page k (default is 1). 

-k Produce A:-column output (default is 1). The options -e and -i are assumed for multi- 

column output. 

-a Print multi-column output across the page. 

-m Merge and print all files simultaneously, one per column (overrides the -k, and -a 
options). 

-d Double-space the output. 

-eck Expand input tabs to character positions A:+l, 2*^+1, etc. If it is 0 or is omitted, 

default tab settings at every eighth position are assumed. Tab characters in the input are 
expanded into the appropriate number of spaces. If c (any non-digit character) is given, 
it is treated as the input tab character (default for c is the tab character). 

Ack In output^ replace white space wherever possible by inserting tabs to character positions 
fc+1, 2*k-\-l, 3*A:-f 1, etc. If A: is 0 or is omitted, default tab settings at every eighth posi¬ 
tion are assumed. If c (any non-digit character) is given, it is treated as the output tab 
character (default for c is the tab character). 

-nek Provide A;-digit line numbering (default for k is 5). The number occupies the first k-\-l 
character positions of each column of normal output or each line of -m output. If c (any 
non-digit character) is given, it is appended to the line number to separate it from what¬ 
ever follows (default for c is a tab). 

-wk Set the width of a line to k character positions (default is 72 for equal-width multi- 
column output, no limit otherwise). 

-ok Offset each line by k character positions (default is 0). The number of character positions 
per line is the sum of the width and offset. 

-\k Set the length of a page to k lines (default is 66). 

-h Use the next argument as the header to be printed instead of the file name. 
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-p Pause before beginning each page if the output is directed to a terminal [pr will ring the 
bell at the terminal and wait for a carriage return). 

-f Use form-feed character for new pages (default is to use a sequence of line-feeds). Pause 
before beginning the first page if the standard output is associated with a terminal. 

-r Print no diagnostic reports on failure to open files. 

-t Print neither the five-line identifying header nor the five-line trailer normally supplied for 
each page. Quit printing after the last line of each file without spacing to the end of the 
page. 

-sc Separate columns by the single character c instead of by the appropriate number of 
spaces (default for c is a tab). 

EXAMPLES 

Print filel and file2 as a double-spaced, three-column listing headed by “file list”: 
pr -3dh "file list" filel file2 

Write filel on file2, expanding tabs to columns 10, 19, 28, 37, ... : 
pr -e9 -t <filel >file2 

FILES 

/dev/tty* to suspend messages 

SEE ALSO 

cat(l), lp(l), ul(l). 
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NAME 

prealloc - preallocate disk storage 

SYNOPSIS 

prealloc name size 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 
DESCRIPTION 

Prealloc will preallocate at least size bytes of disk space for an ordinary file name of zero length. 
It will create the file if it does not already exist. The space will be allocated in an implementation 
dependent fashion for fast sequential reads and writes for the file. 

Prealloc will fail and no disk space will be allocated if name already exists and is not an ordinary 
file of zero length, if there is not enough space left on disk, or if size exceeds the maximum file size 
or the process’ file size limit (see ulimit{2)). The EOF is left at the end of the preallocated area. 
The current file pointer is left at zero. The file is zero-filled. 

DIAGNOSTICS 

Upon successful completion, prealloc exits with a 0 status. Exit status is 1 if name already exists 
and is not an ordinary file of zero length, 2 if there is not enough room on disk, or 3 if size exceeds 
file size limits. 

SEE ALSO 

prealloc(2), ulimit(2) 

BUGS 

The allocation of the file space is highly dependent on the current disk usage. A successful return 
does not tell you how fragmented the file actually might be if the disk is reaching its capacity. 
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NAME 

prof - display profile data 

SYNOPSIS 

prof [ -a ] [ -1 ] [ file ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

Remarks: Prof{l) is implemented on the Series 200 only. 

DESCRIPTION 

Prof interprets the file mon.out produced by the monitor(ZC) subroutine. Under default modes, 
the symbol table in the named object file (a.out default) is read and correlated with the mon.out 
profile file. For each external symbol, the percentage of time spent executing between that symbol 
and the next is printed (in decreasing order), together with the number of times that routine was 
called and the number of milliseconds per call. 

If the -a option is used, all symbols are reported rather than just external symbols. If the -1 
option is used, the output is listed by symbol value rather than decreasing percentage. 

In order for the number of calls to a routine to be tallied, the -p option of cc must have been 
given when the file containing the routine was compiled. This option also arranges for the 
mon.out file to be produced automatically. 

FILES 

mon.out for profile 
a.out for namelist 

SEE ALSO 

cc(l), profil(2), monitor(3C). 

BUGS 

Beware of quantization errors. 
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NAME 

prs - print and summarize an SCCS file 

SYNOPSIS 

prs [-d[dataspec]] [-r[SID]] [-e] [-1] [-c[date-time]] [-a] files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Prs prints, on the standard output, parts or all of an SCCS file (see sccsfile(b)) in a user-supplied 
format. If a directory is named, prs behaves as though each file in the directory were specified as 

a named file, except that non-SCCS files (last component of the path name does not begin with 

s.), and unreadable files are silently ignored. If a name of - is given, the standard input is read; 
each line of the standard input is taken to be the name of an SCCS file to be processed; non-SCCS 
files and unreadable files are silently ignored. 

Arguments to prs, which can appear in any order, consist of keyletter arguments and file names. 

All the described keyletter arguments apply independently to each named file: 

—d[dataspec] Used to specify the output data specification. The dataspec is a string consisting 
of SCCS file data keywords (see Data Keywords below) interspersed with optional 
user-supplied text. 

-r[SID] Used to specify the iiSCCS /Dentification (SID) string of a delta for which infor¬ 
mation is desired. If no SID is specified, the SID of the most recently created 

delta is assumed. If an SID is specified, it must agree exactly with an SID in the 

file (i.e., the SID structure used by get{l) does not work here). 

-e Requests information for all deltas created earlier than and including the delta 

designated via the -r keyletter or the date given by the -c option. 

-1 Requests information for all deltas created later than and including the delta 

designated via the -r keyletter or the date given by the -c option. 

-c [cutoff] Cutoff date-time, in the form 

YY[MM[DD[HH[MM[SS]]]]] 

Units omitted from the date-time default to their maximum possible values. 
Thus, -c7502 is equivalent to -c750228235959. One or more non-numeric 
characters can be used to separate the various 2-digit segments of the cutoff date 
(for example -c77/2/2 9:22:25). 

—a Requests printing of information for both removed; i.e., delta type = R, (see 

rmdel{l)) and existing; i.e., delta type = D, deltas. If the -a keyletter is not 
specified, information for existing deltas only is provided. 

If no option letters (or only -a) are given, prs prints the file name using the default dataspec and 
the -e option. This produces information on all deltas. 

Data Keywords 

Data keywords specify which parts of an SCCS file are to be retrieved and output. All parts of an 
SCCS file (see sccsfile{5)) have an associated data keyword. There is no limit on the number of 
times a data keyword can appear in a dataspec. 

The information printed by prs consists of: (1) the user supplied text; and (2) appropriate values 
(extracted from the SCCS file) substituted for recognized data keywords in their order of appear¬ 
ance in the dataspec. The format of a data keyword value is either Simple (S), where keyword 
substitution is direct, or Multi-line (M), where keyword substitution is followed by a carriage 
return. 
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User-supplied text is any text other than recognized data keywords. Escapes can be used as fol¬ 
lows: 


tab \t 

new-line \n 

colon \: 

backspace \b 

carriage-return \r 

form feed \f 

backslash \\ 

single quote \/ 


The default dataspec is: 

:Dt:\t:DL:\n:MRs:\n:MR:COMMENTS:\n:C: 



TABLE 1. sees Files Data Keywords 



Keyword 

Data Item 

File Section 

Value 

Format 

:Dt: 

Delta information 

Delta Table 

See below* 

S 

;DL: 

Delta line statistics 

" 

:Li:/:Ld:/:Lu: 

S 

;Li: 

Lines inserted by Delta 

" 

nnnnn 

s 

:Ld: 

Lines deleted by Delta 

" 

nnnnn 

s 

:Lu: 

Lines unchanged by Delta 

" 

nnnnn 

s 

:DT: 

Delta type 

" 

D or R 

s 

:I: 

sees ID string (SID) 

" 

:R:.:L:.:B:.:S: 

s 

:R: 

Release number 

" 

nnnn 

s 

:L: 

Level number 

" 

nnnn 

s 

:B: 

Branch number 

" 

nnnn 

s 

:S: 

Sequence number 

" 

nnnn 

s 

:D: 

Date Delta created 

" 

:Dy:/:Dm:/:Dd: 

s 

:Dy: 

Year Delta created 


nn 

s 

:Dm: 

Month Delta created 


nn 

s 

:Dd: 

Day Delta created 

" 

nn 

s 

:T: 

Time Delta created 

" 

:Th:::Tm:::Ts: 

s 

:Th: 

Hour Delta created 

" 

nn 

s 

:Tm: 

Minutes Delta created 


nn 

s 

:Ts: 

Seconds Delta created 


nn 

s 

:P: 

Programmer who created Delta 

" 

logname 

s 

:DS: 

Delta sequence number 

" 

nnnn 

s 

:DP; 

Predecessor Delta seq-no. 


nnnn 

s 

:DI: 

Seq-no. of deltas inch, excl., ignored 


:Dn:/:Dx;/:Dg: 

s 

:Dn: 

Deltas included (seq #) 

" 

:DS: :DS:... 

s 

:Dx: 

Deltas excluded (seq #) 

" 

:DS: :DS:... 

s 

:Dg: 

Deltas ignored (seq #) 

" 

:DS: :DS:... 

s 

:MR; 

MR numbers for delta 

" 

text 

M 

:C: 

Comments for delta 

" 

text 

M 

:UN: 

User names 

User Names 

text 

M 

:FL; 

Flag list 

Flags 

text 

M 

:Y; 

Module type flag 

" 

text 

S 

:MF: 

MR validation flag 

" 

yes or no 

S 

:MP: 

MR validation pgm name 

" 

text 

S 

:KF; 

Keyword error/waming flag 


yes or no 

S 
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TABLE 1 (continued). 

secs Files Data Keywords 



Keyword 

Data Item 

File Section 

Value 

Forma 

:KV: 

Keyword validation string 

" 

text 

S 

:BF: 

Branch flag 

" 

yes or no 

S 

:J: 

Joint edit flag 

" 

yes or no 

s 

:LK: 

Locked releases 


:R:... 

s 

:Q: 

User defined keyword 

" 

text 

s 

:M: 

Module name 

" 

text 

s 

:FB: 

Floor boundary 

" 

:R: 

s 

:CB: 

Ceiling boundary 

" 

:R: 

s 

:Ds: 

Default SID 


:I: 

s 

:ND: 

Null delta flag 

" 

yes or no 

s 

:FD: 

File descriptive text 

Comments 

text 

M 

:BD: 

Body 

Body 

text 

M 

:GB: 

Gotten body 

" 

text 

M 

:W: 

A form of what{\) string 

N/A 

:Z::M:\t:I: 

S 

:A: 

A form of what{l) string 

N/A 

:Z::Y: :M: :I::Z: 

S 

:Z: 

what{l) string delimiter 

N/A 

®m 

s 

:F: 

sees file name 

N/A 

text 

s 

:PN: 

sees file path name 

N/A 

text 

s 


* ;Dt: = :DT: :I: :D; :T: :P: :DS: :DP: 


EXAMPLES 

prs -d"Users and/or user IDs for :F: are:\n:UN:" s.file 
produces text similar to the following on the standard output; 

Users and/or user IDs for s.file are: 

xyz 

131 

abc 

prs -d"Newest delta for pgm :M:: :I: Created :D: By :P:" -r s.file 
produces text similar to the following on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 
As a special case (when no —d key letter is given): 
prs s.file 

produces text similar to the following on the standard output: 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 
MRs: 

bl78-12345 

bl79-54321 

COMMENTS: 

this is the comment line for s.file initial delta 
for each delta table entry of the "D" type. 

FILES 

/tmp/pr????? {temp files exist only while psr is active,} 

SEE ALSO 

admin(l), delta(l), get(l), help(l), sccsfile(5). 

Source Code Control System User’s Guide in HP-UX Concepts and Tutorials. 
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DIAGNOSTICS 

Use help(l) for explanations. 
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NAME 

ps - report process status 

SYNOPSIS 

ps [-edafl] [-C corefile] [-s swapdev] [-n namelist] [-t tlist] [-p plist] [-u ulist] [-g glist] 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V and HP 

DESCRIPTION 

Ps prints certain information about active processes. Without options, information is printed 
about processes associated with the current terminal. The output consists of a short listing con¬ 
taining only the process ID, terminal identifier, cmnulative execution time, and the command 
name. Otherwise, the information that is displayed is controlled by the selection of options. 

Options using lists as arguments can have the list specified in one of two forms: a list of identifiers 
separated from one another by a comma, or a list of identifiers enclosed in double quotes and 
separated from one another by a comma and/or one or more spaces. 

The options are: 


-e 

-d 

-a 

-f 

-1 

-c corefile 
-8 swapdev 

-n namelist 

-t termlist 


-p proclist 
-u uidlist 


-g grplist 


Print information about all processes. 

Print information about all processes, except process group leaders. 

Print information about all processes, except process group leaders and processes not 
associated with a terminal. 

Generate a full listing. (See below for meaning of columns in a full listing.) 

Generate a long listing. (See below.) 

Use the file core file in place of /dev/mem. 

Use the file swapdev in place of /dev/swap. This is useful when examining a 
corefile-, a swapdev of /dev/null will cause the user block to be zeroed out. 

The argument will be taken as the name of an alternate system namelist file in place 

of /hp-ux. 

Restrict listing to data about the processes associated with the terminals given in 
termlist. Terminal identifiers may be specified in one of two forms: the device’s file 
name (e.g., tty04) or if the device’s file name starts with tty, just the digit 
identifier (e.g., 04). 

Restrict listing to data about processes whose process ID numbers are given in pro¬ 
clist. 

Restrict listing to data about processes whose user ID numbers or login names are 
given in uidlist. In the listing, the numerical user ID will be printed unless the -f 
option is used, in which case the login name will be printed. 

Restrict listing to data about processes whose process group leaders are given in 
grplist. 


The column headings and the meaning of the columns in a ps listing are given below; the letters f 
and 1 indicate the option (full or long) that causes the corresponding heading to appear. All 
means that the heading always appears. Note that these two options determine only what infor¬ 
mation is provided for a process; they do not determine which processes will be listed. 

F (1) Flags (octal and additive) associated with the process: 

0 swapped; 

1 in core; 

2 system process; 

4 locked in core (e.g., for physical I/O); 

10 being swapped; 

20 being traced by another process; 
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S (1) 


UID 

(f.i) 

PID 

(all) 

PPID 

(f-1) 

C 

(f4) 

PRI 

(1) 

NI 

(1) 

ADDR 

(1) 

SZ 

(1) 

WCHAN 

(1) 

STIME 

(f) 

TTY 

(all) 

TIME 

(all) 

CMD 

(all) 


40 another tracing flag; 

The state of the process: 

0 non-existent; 

S sleeping; 

W waiting; 

R running; 

I intermediate; 

Z terminated; 

T stopped; 

X growing. 

The user ID number of the process owner; the login name is printed under the -f 
option. 

The process ID of the process; it is possible to kill a process if you know this 
datum. 

The process ID of the parent process. 

Processor utilization for scheduling. 

The priority of the process; higher numbers mean lower priority. 

Nice value; used in priority computation. 

The memory address of the process, if resident; otherwise, the disk address. 

The size in blocks of the core image of the process. 

The event for which the process is waiting or sleeping; if blank, the process is 
running. 

Starting time of the process. 

The controlling terminal for the process (without the initial "tty", if any). 

The cumulative execution time for the process (reported in the form "mimsec"). 
The command name; the full command name and its arguments are printed 
under the -f option. 


A process that has exited and has a parent, but has not yet been waited for by the parent, is 
marked <defunct> (see "zombie process" in exit{2)). 

Under the -f option, ps tries to determine the command name and arguments given when the pro¬ 
cess was created by examining memory or the swap area. Failing this, the command name, as it 
would appear without the -f option, is printed in square brackets. 

To make ps output safer to display and easier to read, all control characters in the CMD field are 
mapped to "visible" equivalents. These are of the form " C where the original character was in the 
range 0 - 037 and c is that value plus 040. 

HARDWARE DEPENDENCIES 

Series 500: 

The F field is always 01. 

In the S field, I means "waiting for input from terminal". 

In the S field, the P (paused) state is added. 

In the S field, the T state is not currently supported. 

In the S field, L means "waiting on a file lock via lockf{2)". 

In the S field, the B (blocked) state means "blocked via an IPC system call such as 
semop{2), msgrcv{2), or msgsnd{2)". 

The C field is always zero. 

The ADDR field reports the partition number. 

In the SZ field, the block size is IK bytes. 

The WCHAN field is always blank. 

The CMD field is renamed COMMAND except when the -fl option is specified. 


The definition of STIME is as follows: 

The time when the process was forked, not the time when it was modified by 
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exec; the date is included only if the elapsed time is greater than 24 hours. 

The s, n, and c options are not currently supported. A diagnostic is printed if they are 
used. 

The files /dev/mem, /dev/swap, /etc/ps—data, and /hp~ux do not exist. 

FILES 

/hp-ux system namelist 
/dev/mem 

memory 

/dev/swap 

the default swap device 
/etc/passwd 

supplies UID information 
/etc/ps_data 

internal data structure 

/dev searched to find terminal (“tty”) names 

SEE ALSO 

acctcom(l), kill(l), nice(l), exec(2), exit(2) lockf(2), msgop(2), semop(2). 

BUGS 

Things can change while ps is running; the picture it gives is only a snapshot in time. Some data 
printed for defunct processes are irrelevant. 

If two special files for terminals are located at the same select code, they are reported in the order 
in which they appear in /dev, not in alphabetical order. 
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NAME 

ptx - permuted index 

SYNOPSIS 

ptx [ options ] [ input [ output ] ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Ptx generates the file output that can be processed with a text formatter to produce a permuted 
index of file input (standard input and output default). It has three phases: the first does the 
permutation, generating one line for each keyword in an input line. The keyword is rotated to the 
front. The permuted file is then sorted. Finally, the sorted lines are rotated so the keyword 
comes at the middle of each line. Ptx output is in the form: 

.XX "tail" "before keyword" "keyword and after" "head" 

where .xx is assumed to be an nroff or troff{l) macro provided by the user, or provided by the 
mptx{7) macro package. The before keyword and keyword and after fields incorporate as much of 
the line as will fit around the keyword when it is printed. Tail and head^ at least one of which is 
always the empty string, are wrapped-around pieces small enough to fit in the unused space at 
the opposite end of the line. 

The following options can be applied: 

-f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter by using a line length of 100. 

-w n Use the next argument, n, as the length of the output line. The default line length is 

72 characters for nroff and 100 for troff. 

-g n Use the next argument, n, as the number of characters that ptx will reserve in its 

calculations for each gap among the four parts of the line as finally printed. The 
default gap is 3. 

-o only Use as keywords only the words given in the only file. 

-i ignore Do not use as keywords any words given in the ignore file. If the -i and -o options 
are missing, use /usr/lib/eign as the ignore file. 

-b break Use the characters in the break file to separate words. Tab, new-line, and space 
characters are always used as break characters. Punctuation characters are treated 
as part of the word in the absence of this option. 

-r Take any leading non-blank characters of each input line to be a reference identifier 

(as to a page or chapter), separate from the text of the line. Attach that identifier as 
a 5th field on each output line. 

The index for this manual was generated using ptx. 

FILES 

/bin/sort 

/usr/lib/eign 

/usr/lib/tmac/tmac.ptx 

SEE ALSO 

nroff(l), troff(l), mm(7), mptx(7). 

BUGS 

Line length counts do not account for overstriking or proportional spacing. 
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Lines that contain tildes (~) are botched, because ptx uses that character internally. 
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NAME 

pwd - working directory name 

SYNOPSIS 

pwd 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Pwd prints the path name of the working (current) directory. 

SEE ALSO 

cd(l). 

DIAGNOSTICS 

“Cannot open and “Read error in indicate possible file system trouble and should be 
referred to the system manager. 
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NAME 

query - interactive IMAGE database access 

SYNOPSIS 

query 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: Query is implemented on the Series 500 only. IMAGE must be previously installed on 
the system for query to function. 

DESCRIPTION 

Query is an interactive, command driven program to simplify IMAGE database access. It 
can be used to generate reports from the database, add information to the database, change 
information in the database, and aid in developing programs that access databases using IMAGE 
library subroutines. 


Consistent with the HP-UX environment in which it operates, query is initiated by simply typing 
its name. There are no options or parameters. Input and output redirection can be done at the 
shell level ( < > ) although more convenient methods are available via query commands. 


A list of the available commands; 



data-base= 

help 

exit 

! 

list 

form 

find 

xeq 

update a 

update d 

update r 

report 

Query accepts these 

commands in upper- or 

lower-case. 

Special care must be taken in the case 

of set names, item 

names, and item values 

since these 

are case sensitive. That is, Setname, 


setname, and SETNAME are three unique sets. 

All query commands must be followed by a semicolon. Query waits silently for a semicolon or a 
zero-length record before processing a command. A zero-length record is entered as a soli¬ 
tary carriage return. This method of signaling the end of a command line enables you to enter 
commands which are several lines long. Line length is limited to 256 characters. At any point 
in a line, you may type a carriage return and continue the command line, thus improving the rea¬ 
dability of long command lines. 

Once initiated, query identifies itself and gives the prompt: 

NEXT? 

Whenever this prompt appears, you may enter any of the query commands, which are described 
below. 

DATA-BASE= 

The data—base= command opens a database. You can type: 
data-base=data_base_name; 

where dato—base^name is the name of a database. If you are presently in the directory 
where the database exists, you need only give the database name. If the database is in 
another directory, you need to supply a partial or complete path name. 

Some examples are: 

dat a-base=/users / fred / inventory; 
specifies a database called "inventory" in the directory /users/fred. 
data-base=equipment; 
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specifies a database called "equipment" in the current directory. 

As part of the data—base= command, query asks for a password for that database with 
the prompt: 

PASSWORD? 

The password is not echoed on the terminal as you type it. As usual, the password must 
be followed by a semicolon. If no password is required, simply press RETURN. 

Provided the database name and password are valid, the database is opened with "modify 
shared" access (DBOPEN mode 1). The command prompt "NEXT?" appears. 

HELP 

The help command provides a syntax model, a brief description, and examples of itself or 
any other query command. It can be invoked in the following ways: 

help [ command ]; 
or 

? [ command ]; 

where command is any query command. If no command is supplied, help describes itself 
and gives a list of the commands for which help is available. 

EXIT The exit command provides you with a graceful way to terminate the query program. It is 
entered thus: 

exit; 

Query can also be terminated by hitting the BREAK key in response to a command prompt. 

f 

At any time, in response to a "NEXT?" prompt, you may wish to execute a shell command 
without leaving the query program. This is useful when debugging report procedure files 
from within query ^ or routing output files to a printer during a query session. For example: 

!pr filename I Ipr 

runs the formatter/printer pr on a file called filename, and pipes the output into the Ipr 
program. 

A shell command following an exclamation mark is executed, and query is suspended until 
that command is completed. Query processing can be continued when the "[Hit return to 
continue QUERY]" message appears. 

LIST The list command is a convenient method of redirecting output from within the query pro¬ 
gram. Query sends output to stdout (the input device) by default. To send output else¬ 
where, type: 

list=filename; 

Output is sent to filename in the current directory. It may be sent to a file in another 
directory by specifying the desired pathname. 

An example is: 

1 ist=/usr / spool/uucppublic / report; 
which specifies that the output file is /usr/spool/uucppublic/report 
If query finds that the named file already exists, it prints the message: 

FILE ALREADY EXISTS. (O)VERWRITE IT, (A)PPEND TO IT, 

OR (N)EITHER ? 

You type o, a, or n to select an option. If you choose n, query prompts: 
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NEW FILE NAME= 

in response to which you provide a (presumably) different file name. Otherwise, query 
overwrites or appends to the selected file, as instructed. Output directed to a file is prop¬ 
erly formatted for direct submission to lpr{\). At any time during a query session, you may 
return output to the terminal by typing: 

list; 

This can be repeated as often as necessary, using the same file or many different files for 
output. When the list command appears in an XEQ file, no choices are offered. The 
specified file is silently opened and any output is appended to it. 

FORM 

The form command outputs a schema description for the open database. It lists each data 
set name, its type (automatic master, manual master, or detail), the set capacity, and the 
current number of entries in the set. With each data set, each item is listed including its 
name, type (alphanumeric, integer, or real), length in bytes, and number of elements in the 
item. Query also identifies key items, sort items (the sort item name may be truncated), 
and indicates whether you have write access for the item. It is initiated by typing: 

form; 

Form’s output is directed to the file specified by the list command, or stdout by default. 
Its output can be terminated by hitting the BREAK key. Within a few seconds, output 
stops and a command prompt (NEXT?) appears. 

FIND 

A major use of any query program is to search a database for an arbitrary group of entries 
meeting some criteria. Find is used in conjunction with the update or report commands, 
providing "victims" for the update or report. It is entered by typing: 

find retrieve_procedure end; 

where retrieve—procedure is a group of data item names, data item values, and relational 
operators joined together by logical connectors. 

A retrieve procedure defines a relationship between a data item and a data item value, and 
the find command collects entries which satisfy that relationship for later use by update 
or report. A typical retrieve procedure looks like this: 

[setname.] itemname operator "value" 

where setname is the name of a data set which contains the data item. It is always 
accepted, but is not necessary when the item name exists in only one data set, or when the 
set name has been previously established in the retrieve procedure. Itemname is simply the 
name of a data item. For compound items, only the first element is used. Operator is one 
of the following relational operators: 


is, ie 

equal to 

isnot, ine 

not equal to 

ilt 

less than 

inlt 

not less than 

igt 

greater than 

ingt 

not greater than 


Value is enclosed in quotation marks (" ") and is compared to the value of the named item 
for each entry in the specified (or implied) set. It should be appropriate for the data item 
type. 

Two or more retrieve procedures can be joined by the logical operators and and or to make 
a more complex procedure. Parentheses are not allowed in find procedures, so care should 
be taken in ordering statements in a compound retrieve procedure. 
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Some examples are: 

find inventory.quantity is "324" end; 

searches all entries in the "inventory" set for a "quantity" equal to "324". This would 
be appropriate for a quantity of any type (alphanumeric, integer, or real). 

find part-description ie "widgit" end; 

searches all entries in the set which contains the item "part-description" for a value of 
"widgit". The value would obviously be inappropriate for an item type of integer or real. 
This example generates an error if "part—description" exists in more than one set in the 
database. 

find inventory.quantity igt "324" and part—description isnot "widgit" end; 

searches all entries in the set "inventory", collecting those that show a quantity greater 
than 324, excluding widgits. The items "quantity" and "part—description" must both be 
items contained in the set "inventory". 

XEQ The xeq command allows any number of commands to be read from a file created by 
any of the HP-UX editors. Commands must appear in the file exactly as they would be 
entered interactively, one command per line. The xeq command is entered: 

xeq=filename; 

The filename may be an absolute pathname, if necessary. Query reads commands from 
that file until it encounters either an end-of-file or another xeq command. When end-of- 
file is reached, query returns to an interactive state. When an xeq command is encountered 
within an xeq file, query closes the current xeq file and begins reading commands from the 
new one. The old one is not re-opened. Xeq files can be nested up to 10 deep. 

A few commands behave differently when they occur in an xeq file. The "list=file" com¬ 
mand silently opens the specified file and appends data to it. The update mode of the 
update r command can be terminated only by a lone semicolon. (In interactive use, 
update r can be terminated by a semicolon or a zero-length record.) 

UPDATE A 

Update a (add) adds entries to a data set. It is the only update which does not 
require a preceding find. The update add command is entered: 

update a, setname; 
or 

update add, setname; 

Query checks the validity of the set name, and then prompts for item values one at a time. 
The item name is displayed followed by an "=". The value to be assigned to that item 
should then be entered, enclosed in quotes, and followed by a semicolon. Query then 
prompts for the next item value. Only one prompt is given for compound data items; the 
item values should be entered each in quotes, separated by commas. Null values may be 
entered by a lone carriage return in response to a prompt, but query insists on valid values 
for key items. Addition of detail entries requires that values for key items already exist in 
the corresponding master set(s). 

The BREAK key can be used to abort an update a command. No update takes place, and a 
command prompt appears. 

UPDATE D 

Update d (delete) deletes entries from a data set. It requires a preceding find, and 
complains if not satisfied. The command is entered: 

update d; 
or 
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update delete; 

As a safety check, query asks "OK TO DELETE?(YES/NO)". Upon receipt of a y or n, 
query proceeds as directed. It refuses to delete master set entries which contain chain heads 
with non-empty chains (i.e. connected detail sets), and displays a message to that effect. 

UPDATE R 

Update r (replace) also must be preceded by a find. It is a means of changing item values 
in an existing entry. It is invoked by typing: 

update r; 
or 

update replace; 

Query responds with the prompt "ITEM =". You then enter: 
item_name= "value"; 

where item^name is an item name which exists in the entries in the select file. Value is a 
value appropriate to the item type (alpha, integer, or real) enclosed in double quotes. 

When you have finished entering the changes desired, a lone carriage return or a lone semi¬ 
colon exits this update mode, and query executes the changes and returns to the command 
level. (In an xeq file, only the semicolon sufiices.) The new value(s) are inserted into all 
entries collected in the select file. Updates are refused for key items and sort items in mas¬ 
ter sets. Updating key or sort items in detail sets causes that record to be deleted and re¬ 
entered with the new values. A report following such an update may give an "EMPTY 
RECORD" error message. Don’t panic. The record may be found at its new location by a 
find command. 

The BREAK key can be used to abort an update r command. No update takes place, and 
a command prompt appears. 

REPORT 

The report command provides many features to display information about the entries in 
the select file. The information is sent to the list device (the input device, by 
default). Report’s output can be terminated by using the BREAK key, which yields a 
command prompt (NEXT?). You can request the name and value of each data item for 
all the data entries specified in the select file, or request the data item values for all of 
the data entries without printing the data item name. Also you may create output 
formats complete with page headings, page numbers, column headings, space and page 
control, and selectivity in item value display. Report can be invoked in one of three 
ways: 

report all [, character ]; 
or 

report name=procedure_Qame; 
or 

report; 

body 

end; 

where character is any ASCII printing character which determines the printing of certain 
optional information. 

Procedure—name is the name of a file (specified as a relative or absolute pathname) which 
contains report commands stored via a system editor, such as ed or vi 

Body consists of header, detail, edit, and sort commands as outlined below. 

The three forms of the report command are described below. 
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REPORT ALL [,CHARACTER]; 

prints the entire data item and all elements of a compound item. This report form 
prints the item name, followed by followed by the item value. The optional 

character causes query to print only the item value, without the item name and 
All item values appear left justified, and numbers are stripped of insignificant zeros. 
Real numbers may appear in decimal form or scientific notation, as necessary. This is 
the only report form which shows all values for compound data items. 

REPORT NAME=PROCEDURE_ISrAME; 

gets header, detail, edit, and sort commands from a file, reading commands until an 
"end;" or an error is encountered. The contents of a procedure file are identical to 
the "body" in the next form of the report command. It should be noted that the use 
of the shell escape (!) is a valuable aid in the development of procedure files. It 
enables you to invoke an editor, modify a file, exit it, and return to the same point in 
query to test the file, without having to re-define the database or re-establish a 
select file. 

REPORT; 

BODY 

END; accepts report commands from the user, scanning each line as it is entered for syn¬ 
tax errors. The entry of an "end;" command initiates the execution of the commands, 
producing a report. The body is a collection of the following commands: 

Header Prints title, column headings, and page numbers at the top of each 
report page. 

Detail Prints data item values in the column position specified. 

Edit Describes the number of decimal places to be displayed for real 

numbers. 

Sort Sorts data entries based upon the value of a specified data item. 

Report Formatting 

The above commands can be formatted using the following parameters. (Note: these are parame¬ 
ters to the report commands, not commands themselves.) 

print position 

Specifies the ending column for an item value or heading. 
space and space control 

Causes line skips between item values or heading lines. 
skip and skip control 

Causes page skips between item values or heading lines. 

edit 

Specifies edit commands to which output item values should conform. 

These parameters are described below. 

print position 

This parameter is an integer between 1 and 132 which indicates the column 
number in which the last character of an item value should appear in a header or 
detail line. It is your responsibility to avoid overlap between fields on the same line. 
However, in most cases query replaces an overlapping value with asterisks to indi¬ 
cate an error. 

space and space control 

This parameter outputs blank lines either before or after the printing of a header 
string or detail line value. The keyword space should be followed by either an a or 
b, indicating where the blank line should appear - after or before the line to be 
printed. The a or b may be followed by an integer in the range 1 - 5, to skip 
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multiple lines. Absence of the integer causes query to skip 1 line. These may appear 
more than once in a command, as in spacing before and after a line: 

hi,"page",35,space b2,space a3; 

This generates two blank lines before printing "page", and three blank lines after¬ 
ward. 

skip and skip control 

Similar to space, skip yields page feeds either before or after the printing of a line. 
Unlike space, skip can only be used with a "detail" command. The keyword skip 
is followed by an a or b to direct where the page feed should be placed (see "space 
and space control" above). Normally, query prints 54 lines per page before skipping 
to a new page. 

edit 

The edit parameter is the letter e followed by an integer in the range 0-9. This 
number corresponds to a numbered edit command which specifies the number of 
decimal places (for real numbers) or the number of characters (for alphanumeric 
strings) to be printed. 

Report Commands 

h (header command) 

The header command is used to print heading information of your choice at the 
top of each page of the report. A maximum of five lines of header information 
can appear at the top of each report page. The format of the header command is: 

hnumber,data_type,print_position [,space space-control); 

where number is an integer from 1 to 5 specifying on which header line (out of five 
possible lines) the information is to appear. Header information in a header com¬ 
mand labeled "hi" appears in the first line, "h2" appears in the second line, etc. 

Data—type is either an ASCII character string enclosed in double quotes, or the 
word pageno (without quotes). If pageno appears in the header command, query 
prints the page number of the report in the position specified by print—position. 
Query increments the page number automatically for each page printed. 

Print—position^ space, and space-control are parameters defined in the section on 
report formatting. 

An example is: 

hl,"PAGE",70,space b2; 
hl,pageno,76; 

h2,"DAILY REPORT",50,space a3; 

which prints the word "PAGE" with the letter "E" in column 70, on the second 
line from the top of a page (via the "space b2" parameter). On the same line, the 
page number is printed ending in column 76. The next line contains "DAILY 
REPORT" ending in column 50, followed by three blank lines. 

d (detail command) 

The detail command indicates which data items of a data entry specified in the 
select file are to be printed in the report. Data items can be printed on up to 10 
different lines. Query prints only the values of data items which appear in a detail 
command. 

If an ASCII value length exceeds the distance between a preceding value on the 
same line or the left margin, it is silently truncated on the left. If a numeric 
value overlaps in the same manner, it is replaced by a series of asterisks, indicat¬ 
ing the error. 
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Detail commands without an edit parameter print numeric values in whatever for¬ 
mat necessary to give maximum accuracy. 

The format of a detail command is: 

d[n] ,data_type,print_position [, space space-control ] [, skip 
skip-control ] [, edit ]; 

where n is an integer from 1 to 9. Each number specifies a different line on which 
the data items are printed. If the number is omitted, the unnumbered detail item is 
printed on a separate line above any numbered detail item lines. The lowest num¬ 
bered command is printed first and all others follow in numeric order. Detail com¬ 
mands with the same number are printed on the same line. 

Data.—type is either an ASCII character string enclosed in double quotes, or the 
name of a data item contained in the data entries specified in the select file. NOTE: 
the report command processor expects the data item name by itself. Preceding the 
item name with a set name generates an error. 

Print—position^ space, space-control, skip, skip-control, and edit are parameters 
defined in the section on report formatting. 

e (edit command) 

The edit command is used to format the printing of real and/or alphanumeric item 
values. Up to ten edit commands, labeled from eO to e9, can be used in a report. 
To edit output from a detail command, you include the label of the desired edit 
command. Query refers to the labeled edit command to edit the value printed by 
the detail command. The same edit command can be referenced by more than one 
detail command in the same report, and each edit command must be referenced at 
least once in the report body. The format of the edit command is: 

enumber, "places,format"; 

where number is an integer from 0 to 9, identifying the edit command. An integer 
cannot be used to identify more than one edit command. 

Places is an integer indicating the number of digits to follow the decimal point (for 
real numbers) or the number of characters to be printed (for alphanumeric strings). 

Format is one of the following single letters: 

f indicating that the number should be formatted in decimal form, 
with the specified number of digits following the decimal point. 
Numbers accurate to more than the specified number of places are 
rounded. 

e indicating that the number should be formatted in scientific notation 
with the specified number of digits following the decimal point. 

s indicating that the data item is an alphanumeric string. The number 
of characters printed is specified by the accompanying integer. If 
you specify 10 characters for a data item 40 characters in length, the 
leftmost 10 characters are printed. If you specify 100 characters for 
the same data item, only 40 characters are printed. 

Here are some examples: 
el,"Of"; 

dl,real_number,40,el; 
might yield such numbers as: 

2.340000 

25487.123456 
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1.000000 

and 

el,"4e"; 

dl,realnum,40,el; 
might yield 

2.3400e+0 

3.2549e+5 

l.OOOOe+0 

and 

el,"15s"; 
dl,String,40,el; 

might yield 

Smith, Jame 
truncate ri 
Walker, Man 
Doe, John 

Finally, the difference between the edit command and the edit parameter should be 
emphasized. For example, 

el,"7f"; 

dl,Any_real,30,el; 

end; 

The first line is an edit command, specifying a format for real numbers. In the 
second line, the "el" is a parameter, indicating that the real number(s) "Any_rear' 
should be printed according to the format shown in the "el" command. 

s (sort command) 

The sort command specifies an item upon which you want the entries in the select 
file sorted. The format of the sort command is: 

s,itemname; 

where itemname is the name of a data item which appears in entries currently 
stored in the select file. 

A sort item value may not exceed 80 bytes in length. In the case of a compound 
data item, sort uses only the first value in that item. After a "find", the entries 
appear in the select file in the order the find command encounters them. The sort 
command will rearrange those entries in ascending alphabetic or numeric order, 
depending on the sort item. 

Report Example 

Assuming that Emp^name is a 20-byte alphanumeric item, Emp—age is a 2-byte integer, and 
Emp—wage is a 4-byte real: 

HI,"EMPLOYEE REPORT",34,space b3; 
hl,"PAGE",52; 
hl,pageno,56,space a2; 
h2,"NAME",7; 

H2,"AGE",27; 

H2,"HOURLY WAGE",52; 
el,"2f"; 
s,Emp__name; 
d 1, Emp__name, 20; 
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dl,Emp_age,27; 

dl,"$",44; 

dl,Emp_wage,50,el,space a; 
end; 

This report might yield: 


EMPLOYEE REPORT 


PAGE 1 


NAME 

AGE 

HOURLY WAGE 

Anderson, Richard 

32 

$ 14.75 

Carr,Elaine 

21 

$ 11.50 

Wilson,Kathy 

42 

$ 17.25 


Summary 

Although the commands appear throughout this document in lower-case, query accepts them in 
upper-case also. This is helpful when working with databases ported from Series 500 BASIC, in 
which database names, data set names, and data item names are frequently in upper-case. 

It should be stressed that all commands must end with a semicolon or zero-length entry. If 
query seems to have "gone away", be sure that a semicolon followed tha last command 
entered. If this is not the case, an extra carriage return serves to terminate the command 
and prompt query into action. 

Query sometimes appears to be "eating" report commands and doing nothing about them, 
other than supplying the "NEXT?" prompt. This is usually the result of having used the 
"list" command to re-route output earlier in the session, and having forgotten about it. 
Typing 

list; 

re-routes output to the terminal again. 

Abnormal termination of query leaves files in /usr/tmp. It is your responsibility to 
remove these files or they may accumulate and use up large amounts of memory. The files 
can be identified by the owner id, shown by typing "11 /usr/tmp". Do not attempt to 
remove files belonging to anyone else. 

FILES 

/usr/lbin/query 

/usr/lbin/querysort query’s own sort routine 

/usr/lib/query.help help file 

/usr/tmp/* temporary files 
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NAME 

ratfor - rational Fortran dialect 
SYNOPSIS 

ratfor [ options ] [ files ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides 
control fiow constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

} 

loops: 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 
free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment. 

compiler directives: 

directives beginning with a dollar sign ($) in column one are passed through to 
the compiler unchanged. 

translation of relational: 

>, >=, etc., become .GT., .GE., etc. 

return expression to caller from function: 
return (expression) 

define: 

define name replacement 

include: 

include file 
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The options are as follows: 

-h causes quoted strings to be turned into Hollerith constructs. 

-C copies comments to the output and attempts to format it neatly. 

-6c Normally, continuation lines are marked with an &; in column 1; the option -6c makes the 
continuation character c and places it in column 6. 

Ratfor is best used with /c(l). 

-d compatibility mode for earlier versions of ratfor. 

HARDWARE DEPENDENCIES 

Series 500: 

Fc{l) does not recognize ratfor.r files. Therefore, ratfor must be called directly. 

The -h option should not be used. 

The -6x option must be used for successful automatic continuation. 

SEE ALSO 

efl(l), fc(l). 

B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

rev - reverse lines of a file 

SYNOPSIS 

rev [ file ] ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Rev copies the named files to the standard output, reversing the order of characters in every line. 
If no file is specified, the standard input is copied. 
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NAME 

revision - get HP-UX revision information 

SYNOPSIS 

/usr/bin/revision 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: Revision is implemented on the Series 500 only. 

DESCRIPTION 

This command prints six lines to standard output. Those six lines consist of the six data items 
output by uname{2), which give information on the kernel. 

The following is a sample output from a machine whose loader chip was not programmed with a 
serial number: 


System: 

HP-UX 

Release: 

TEST23# 

Version: 

B 

Machine: 


Identity: 

HP-UX 

Nodename: 

hpfcla 


SEE ALSO 

uname(2). 
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NAME 

rm, rmdir - remove files or directories 

SYNOPSIS 

rm [ -fri ] file ... 

rmdir dir ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Rm removes the entries for one or more files from a directory. If an entry was the last link to the 
file, the file is destroyed. Removal of a file requires write permission in its directory, but neither 
read nor write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are printed 
and a line is read from the standard input. If that line begins with y the file is deleted, otherwise 
the file remains. No questions are asked when the -f option is given or if the standard input is not 
a terminal. 

If a designated file is a directory, an error comment is printed unless the optional argument -r has 
been used. In that case, rm recursively deletes the entire contents of the specified directory, and 
the directory itself. (Note that rm can recursively remove a maximum of 17 directory levels.) 

If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, 
whether to examine each directory. 

Rmdir removes entries for the named directories, which must be empty and have execute permis¬ 
sion for the user trying to remove them. 

SEE ALSO 

unlink(2). 

DIAGNOSTICS 

Generally self-explanatory. It is forbidden to remove the file .. merely to avoid the consequences 
of inadvertently doing something like: 

rm -r .* 
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NAME 

rmdel - remove a delta from an SCCS file 

SYNOPSIS 

rmdel -rSID files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Rmdel removes the delta specified by the SID from each named SCCS file. The delta to be 
removed must be the newest (most recent) delta in its branch in the delta chain of each named 
SCCS file. In addition, the SID specified must not be that of a version being edited for the purpose 
of making a delta (i. e., if a p-file (see get{l)) exists for the named SCCS file, the SID specified 
must not appear in any entry of the p-file). 

If a directory is named, rmdel behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path name does not begin with s.) 
and unreadable files are silently ignored. If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be processed; non-SCCS files 
and unreadable files are silently ignored. 

The exact permissions necessary to remove a delta are documented in the Source Code Control 
System User’s Guide. Simply stated, they are either (1) if you make a delta you can remove it; or 
(2) if you own the file and directory you can remove a delta. 

FILES 

x.file (see delta{l)) 

z.file (see delta{l)) 

SEE ALSO 

delta(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control System User’s Guide in HP-UX Concepts and Tutoials. 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

rmnl - remove extra new-line characters from file 

SYNOPSIS 

rmnl 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

DESCRIPTION 

Rmnl is useful for removing excess white space from files for display on a crt terminal. Groups of 
more than one \n character are compressed to one \n character, effectively removing all blank 
lines. This is used by the man command. 

can be used to remove redundant blank lines, rather than all blank lines. 

SEE ALSO 

ssp(l), man(l). 
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NAME 

rtprio - execute process with realtime priority 

SYNOPSIS 

rtprio priority command [ arguments ] 
rtprio priority -pid 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

DESCRIPTION 

Rtprio executes command with a realtime priority, or changes the realtime priority of currently 
executing process pid. Realtime priorities range from one (highest) to 127 (lowest), a priority of 
zero indicates normal unix process scheduling which effectively makes the process non-realtime. 
Realtime processes are not subject to priority degradation and are all of greater (scheduling) 
importance than non-realtime processes. See rtprio{2) for more details. 

Command will not be scheduled, or pid's realtime priority will not be changed, if the user is not a 
member of a group having PRIV_RTPRIO access or is not the super-user. When changing the 
realtime priority of a currently executing process, the effective user ID of the calling process must 
be superuser, or the real or effective user ID must match the real or effective user ID of the pro¬ 
cess to be modified. 

SEE ALSO 

rtprio (2), getprivgrp(2) 

DIAGNOSTICS 

Rtprio returns exit status 0 if command is successfully scheduled or if pid^s realtime priority is 
successfully changed, 1 if command is not executable or pid does not exist, 2 if command (pid) 
lacks realtime capability, or the invoker’s effective user ID is not superuser or effective user ID 
does not match the real or effective user ID of the process to be changed. 
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NAME 

sact - print current SCCS file editing activity 

SYNOPSIS 

sact files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Sact informs the user of any impending deltas to a named SCCS file. This situation occurs when 
get{l) with the -e option has been previously executed without a subsequent execution of delta{1). 
If a directory is named on the command line, sact behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files (last component of path name does not 
begin with s.) and unreadable files are silently ignored. If a name of - is given, the standard 
input is read with each line being taken as the name of an SCCS file to be processed. 

The output for each named file consists of five fields separated by spaces. 

Field 1 specifies the SID of a delta that currently exists in the SCCS file to which 

changes will be made to make the new delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who will make the delta (i.e., executed a get 

for editing). 

Field 4 contains the date that get -e was executed. 

Field 5 contains the time that get -e was executed. 

SEE ALSO 

delta(l), get(l), unget(l). 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

sccsdiff - compare two versions of an SCCS file 

SYNOPSIS 

sccsdiff -rSIDl -rSID2 [-p] [-sn] files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 


DESCRIPTION 

Sccsdiff compares two versions of an SCCS file and generates the differences between the two ver¬ 
sions. Any number of SCCS files may be specified, but arguments apply to all files. 


-rSID? SIDl and SID2 specify the deltas of an SCCS file that are to be compared. 

Versions are passed to bdiff{l) in the order given. The SID’s accepted, and the 
corresponding version retrieved for the comparison are the same as for get{l). 

-p pipe output for each file through pr{l). 

-sn n is the file segment size that bdiff will pass to diff{l). This is useful when diff 

fails due to a high system load. 


FILES 

/tmp/get????? Temporary files 


SEE ALSO 

bdiff(l), diff(l), get(l), help(l), pr(l). 

Source Code Control System User’s Guide in HP-UX: Selected Articles. 

DIAGNOSTICS 

“/e/e: No differences” if the two versions are the same. 

Use help{l) for explanations. 
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NAME 

sed - stream text editor 

SYNOPSIS 

sed [ -n ] [ -e script ] [ -f sfile ] [ files ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard output, edited according to a 
script of commands. The -f option causes the script to be taken from file sfile', these options 
accumulate. If there is just one -e option and no -f options, the flag -e may be omitted. The -n 
option suppresses the default output. A script consists of editing commands, one per line, of the 
following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern space (unless there is 
something left after a D command), applies in sequence all commands whose addresses select that 
pattern space, and at the end of the script copies the pattern space to the standard output 
(except under -n) and deletes the pattern space. 

Some of the commands use a hold space to save all or part of the pattern space for subsequent 
retrieval. 

An address is either a decimal number that counts input lines cumulatively across files, a $ that 
addresses the last line of input, or a context address, i.e., a jregular expression j in the style of 
ed{l) modified thus: 

In a context address, the construction \ ?regular expression?, where ? is any character, is 
identical to f regular expression!. Note that in the context address 

\xabc\xdefx, the second x stands for itself, so that the regular expression is 

abcxdef. 

The escape sequence \n matches a new-line embedded in the pattern space. 

A period . matches any character except the terminal new-line of the pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that matches the address. 

A command line with two addresses selects the inclusive range from the first pattern 
space that matches the first address through the next pattern space that matches 
the second. (If the second address is a number less than or equal to the line 
number first selected, only one line is selected.) Thereafter the process is 
repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the negation func¬ 
tion ! (below). 

In the following list of functions the maximum number of permissible addresses for each function 
is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of which end with \ to hide the 
new-line. Backslashes in text are treated like backslashes in the replacement string of an s com¬ 
mand, and may be used to protect initial blanks and tabs against the stripping that is done on 
every script line. The rfile or wfile argument must terminate the command line and must be pre¬ 
ceded by exactly one blank. Each wfile is created before processing begins. There can be at most 
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10 distinct wfile arguments. 

(1) a\ 

text Append. Place text on the output before reading the next input line. 

(2) b label Branch to the : command bearing the label. If label is empty, branch to the end of the 
script. 

Change. Delete the pattern space. With 0 or 1 address or at the end of a 2-address 
range, place text on the output. Start the next cycle. Ignores any subsequent opera¬ 
tions related to the deleted space. 

Delete the pattern space. Start the next cycle. Ignores any subsequent operations 
related to the deleted pattern space. 

Delete the initial segment of the pattern space through the first new-line. Start the 
next cycle. 

Replace the contents of the pattern space by the contents of the hold space. 

Append the contents of the hold space to the pattern space. 

Replace the contents of the hold space by the contents of the pattern space. 

Append the contents of the pattern space to the hold space. 

Insert. Place text on the standard output. 

List the pattern space on the standard output in an unambiguous form. Non-printing 
characters are spelled in two-digit ASCII and long lines are folded. 

Copy the pattern space to the standard output. Replace the pattern space with the 
next line of input. 

Append the next line of input to the pattern space with an embedded new-line. (The 
current line number changes.) 

Print. Copy the pattern space to the standard output. 

Copy the initial segment of the pattern space through the first new-line to the stan¬ 
dard output. 

Quit. Branch to the end of the script. Do not start a new cycle. 

Read the contents of rfile. Place them on the output before reading the next input 
line. 

(2) s/ regular expression/replacement/flags 

Substitute the replacement string for instances of the regular expression in the pattern 
space. Any character may be used instead of /. For a fuller description see ed{l). 
Flags is zero or more of: 

n n= 1 - 512. Substitute for just the n th occurrence of the regular 

expression. 

g Global. Substitute for all nonoverlapping instances of the regular 

expression rather than just the first one. 
p Print the pattern space if a replacement was made, 

w wfile Write. Append the pattern space to wfile if a replacement was made. 
(2) t label Test. Branch to the : command bearing the label if any substitutions have been made 
since the most recent reading of an input line or execution of a t. If label is empty, 
branch to the end of the script. 

(2)w wfile Write. Append the pattern space to wfile. 

(2) X Exchange the contents of the pattern and hold spaces. 

(2) y/stringl /string2/ 

Transform. Replace all occurrences of characters in stringl with the corresponding 
character in string2. The lengths of stringl and string2 must be equal. 

(2)! function 

Don’t. Apply the function (or group, if function is {) only to lines not selected by the 
address (es). 


(2)c\ 

text 


{2)d 

(2)D 

{2)g 

{2)G 

(2)h 

(2)H 

(1) i\ 

text 

( 2 ) 1 

(2)n 

(2)N 

(2)P 

{2)P 

(1) q 

(2) r rfile 
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(0): label This command does nothing; it bears a label for b and t commands to branch to. 

(1) = Place the current line mnnber on the standard output as a line. 

(2) { Execute the following commands through a matching } only when the pattern space is 

selected. The syntax is: 

{ cmdl 

cmd2 

cmd3 


} 

(0) An empty command is ignored. 

(0) # If a # appears as the first character on the first line of a script file, then that entire 
line is treated as a comment, with one exception. If the character after the # is an ’n’, 
then the default output will be suppressed. The rest of the line after #n is also 
ignored. A script file must contain at least one non-comment line. 

SEE ALSO 

awk(l), ed(l), grep(l). 

BUGS 

There is a limit of 100 commands in the script. 


Hewlett-P ackard 


- 3- 


November 19, 1985 



SH(1) 


SH(1) 


NAME 

sh, rsh - shell, the standard/restricted command programming language 

SYNOPSIS 

sh [ -acefhiknrstuvx ] [ args ] 
rsh [ -acefhiknrstuvx ] [ args ] 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

Native Language Support: 

8-bit filenames. 

DESCRIPTION 

Sh is a command programming language that executes commands read from a terminal or a file. 
Rsh is a restricted version of the standard command interpreter sh; it is used to set up login 
names and execution environments whose capabilities are more controlled than those of the stan¬ 
dard shell. See Invocation below for the meaning of arguments to the shell. 

Definitions 

A blank is a tab or a space. A name is a sequence of letters, digits, or underscores beginning with 
a letter or underscore. A parameter is a name, a digit, or any of the characters *, @, #, ?, -, $, 
and !. 

Commands 

A simple-command is a sequence of non-blank words separated by blanks. The first word 
specifies the name of the command to be executed. Except as specified below, the remaining 
words are passed as arguments to the invoked command. The command name is passed as argu¬ 
ment 0 (see exec(2)). The value of a simple-command is its exit status if it terminates normally, 
or (octal) 200+status if it terminates abnormally (see signal{2) for a list of status values). 

A pipeline is a sequence of one or more commands separated by | (or, for historical compatibility, 
by "). The standard output of each command but the last is connected by a pipe{2) to the stan¬ 
dard input of the next command. Each command is run as a separate process; the shell waits for 
the last command to terminate. The exit status of a pipeline is the exit status of the last com¬ 
mand. 

A list is a sequence of one or more pipelines separated by ;, &&:, or 11, and optionally ter¬ 

minated by ; or &. Of these four symbols, ; and &; have equal precedence, which is lower than 
that of and 11. The symbols && and 11 also have equal precedence. A semicolon (;) causes 

sequential execution of the preceding pipeline; an ampersand (&;) causes asynchronous execution 
of the preceding pipeline (i.e., the shell does not wait for that pipeline to finish). The symbol && 
(II) causes the list following it to be executed only if the preceding pipeline returns a zero (non¬ 
zero) exit status. An arbitrary number of new-lines may appear in a list, instead of semicolons, 
to delimit commands. 

A command is either a simple-command or one of the following. Unless otherwise stated, the 
value returned by a command is that of the last simple-command executed in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next word taken from the in 
word list. If in word ... is omitted, then the for command executes the do list once for 
each positional parameter that is set (see Parameter Substitution below). Execution ends 
when there are no more words in the list, 
case word in [ pattern [ | pattern ) ... ) list ;; ] ... esac 

A case command executes the list associated with the first pattern that matches word. 
The form of the patterns is the same as that used for file-name generation (see File Name 
Generation) except that a slash, a leading dot, or a dot immediately following a slash 


Hewlet t-P ackard 


- 1 - 


July 2, 1985 



SH(1) 


SH(1) 


need not be matched explicitly, 
if list then list [ elif list then list ] ... [ else list ] fi 

The list following if is executed and, if it returns a zero exit status, the list following the 
first then is executed. Otherwise, the list following elif is executed and, if its value is 
zero, the list following the next then is executed. Failing that, the else list is executed. 
If no else list or then list is executed, then the if command returns a zero exit status, 
while list do list done 

A while command repeatedly executes the while list and, if the exit status of the last 
command in the list is zero, executes the do list; otherwise the loop terminates. If no 
commands in the do list are executed, then the while command returns a zero exit 
status; until may be used in place of while to negate the loop termination test. 

(list) 

Execute list in a sub-shell. 

list is simply executed. 
name () {list’,} 

Define a function which is referenced by name. The body of the function is the list of 
commands between { and }. Execution of functions is described below (see Execution). 

The following words are only recognized as the first word of a command and when not quoted: 

if then else elif fi case esac for while until do done { } 

Comments 

A word beginning with # causes that word and all the following characters up to a new-line to be 
ignored. 

Command Substitution 

The standard output from a command enclosed in a pair of grave accents (^ ) may be used as 

part or all of a word; trailing new-lines are removed. 

Parameter Substitution 

The character $ is used to introduce substitutable parameters. There are two types of parame¬ 
ters, positional and keyword. If parameter is a digit, it is a positional parameter. Positional 
parameters may be assigned values by set. Keyword parameters (also known as variables) may 
be assigned values by writing: 

name=value [ name=value ] ... 

Pattern-matching is not performed on value. There cannot be a function and a variable with the 
same name. 

%{parameter} 

The value, if any, of the parameter is substituted. The braces are required only when 
parameter is followed by a letter, digit, or underscore that is not to be interpreted as part 
of its name. If parameter is * or @, all the positional parameters, starting with $ 1 , are 
substituted (separated by spaces). Parameter $0 is set from argument zero when the 
shell is invoked. 

${parameter>word} 

If parameter is set and is non-null, substitute its value; otherwise substitute word. 
${parameter:—word} 

If parameter is not set or is null set it to word; the value of the parameter is then substi¬ 
tuted. Positional parameters may not be assigned to in this way. 

${parameter:? word} 

If parameter is set and is non-null, substitute its value; otherwise, print word and exit 
from the shell. If word is omitted, then the message “parameter null or not set” is 
printed. 
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${parameter:-\-word} 

If parameter is set and is non-null then substitute word; otherwise substitute nothing. 

In the above, word is not evaluated unless it is to be used as the substituted string, so that, in the 
following example, pwd is executed only if d is not set or is null: 

echo ${d:- ^ pwd ^ } 

If the colon (:) is omitted from the above expressions, then the shell only checks whether param¬ 
eter is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

Flags supplied to the shell on invocation or by the set command. 

? The decimal value returned by the last synchronously executed command. 

$ The process number of this shell. 

! The process number of the last background command invoked. 

The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd command. 

PATH The search path for commands (see Execution below). The user may not change 
PATH if executing under rsh. 

CDPATH 

The search path for the cd command. 

MAIL If this parameter is set to the name of a mail file and the MAILPATH parameter 
is not set, the shell informs the user of the arrival of mail in the specified file. 
MAILCHECK 

This parameter specifies how often (in seconds) the shell will check for the arrival 
of mail in the files specified by the MAILPATH or MAIL parameters. The 
default value is 600 seconds (10 minutes). If set to 0, the shell will check before 
each prompt. 

MAILPATH 

A colon (:) separated list of file names. If this parameter is set, the shell informs 
the user of the arrival of mail in any of the specified files. Each file name can be 
followed by % and a message that will be printed when the modification time 
changes. The default message is you have mail. 

PSl Primary prompt string, by default 

PS2 Secondary prompt string, by default “> ”. 

IFS Internal field separators, normally space, tab, and new-line. 

SHACCT 

If this parameter is set to the name of a file writable by the user, the shell will 
write an accounting record in the file for each shell procedure executed. Account¬ 
ing routines such as acctcom{l) and acctcms (IM) can be used to analyze the 
data collected. 

SHELL 

When the shell is invoked, it scans the environment (see Environment below) for 
this name. If it is found and there is an ’r’ in the file name part of its value, the 
shell becomes a restricted shell. SHELL is also used by some to run. 

The shell gives default values to PATH, PSl, PS2, MAILCHECK and IFS. HOME and MAIL 
are set by login{l). 

Blank Interpretation 

After parameter and command substitution, the results of substitution are scanned for internal 
field separator characters (those found in IFS) and split into distinct arguments where such char¬ 
acters are found. Explicit null arguments ("" or ' are retained. Implicit null arguments 
(those resulting from parameters that have no values) are removed. 
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File Name Generation 

Following substitution, each command word is scanned for the characters *, ?, and [. If one of 
these characters appears then the word is regarded as a pattern. The word is replaced with 
alphabetically sorted file names that match the pattern. If no file name is found that matches the 
pattern, then the word is left unchanged. The character . at the start of a file name or immedi¬ 
ately following a /, as well as the character / itself, must be matched explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

[... ] Matches any one of the enclosed characters. A pair of characters separated by - 
matches any character lexically between the pair, inclusive. If the first character 
following the opening " [ " is a “!” any character not enclosed is matched. 

Quoting 

The following characters have a special meaning to the shell and cause termination of a word 
unless quoted: 

;&()!"<> new-line space tab 

A character may be quoted (i.e., made to stand for itself) by preceding it with a \. The pair 
\new-line is ignored. All characters enclosed between a pair of single quote marks { ' except 
a single quote, are quoted. Inside double quote marks (""), parameter and command substitution 
occurs and \ quotes the characters \, ' , ", and $. "$*" is equivalent to "$1 $2 ...", whereas 
is equivalent to "$1" "$2" _ 

Prompting 

When used interactively, the shell prompts with the value of PSl before reading a command. If 
at any time a new-line is typed and further input is needed to complete a command, then the 
secondary prompt (i.e., the value of PS2) is issued. 

Input / Output 

Before a command is executed, its input and output may be redirected using a special notation 
interpreted by the shell. The following may appear anywhere in a simple-command or may pre¬ 
cede or follow a command and are not passed on to the invoked command; substitution occurs 
before word or digit is used: 

<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). If the file does not exist then 

it is created; otherwise, it is truncated to zero length. 

»word Use file word as standard output. If the file exists then output is appended to it 

(by first seeking to the end-of-file); otherwise, the file is created. 

«[-]word The shell input is read up to a line that is the same as word, or to an end-of-file. 

The resulting document becomes the standard input. If any character of word is 
quoted, then no interpretation is placed upon the characters of the document; 
otherwise, parameter and command substitution occurs, (unescaped) \new-line 
is ignored, and \ must be used to quote the characters \, $, ^, and the first char¬ 
acter of word. If - is appended to «, then all leading tabs are stripped from 
word and from the document. 

<&:digit Use the file associated with file descriptor digit as standard input. Similarly for 

the standard output using >&:digit. (See dup{2)). 

<Sc- The standard input is closed. Similarly for the standard output using >&-. 

If any of the above is preceded by a digit, then the file descriptor which will be associated with 
the file is that specified by the digit (instead of the default 0 or 1). For example: 

... 2>kl 

associates file descriptor 2 with the file currently associated with file descriptor 1. Note that this 
type of I/O redirection is necessary if you want to synchronously collect stdout and stderr output 
in the same file. Redirecting stdout and stderr separately will cause asynchronous collection of 
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data at the destination (i.e. things written to stdout can subsequently be over-written by things 
written to stderr, and vice-versa). 

The order in which redirections are specified is significant. The shell evaluates redirections left- 
to-right. For example: 

... l>xxx 2>hl 

first associates file descriptor 1 with file xxx . It associates file descriptor 2 with the file associated 
with file descriptor 1 (i.e. xxx). If the order of redirections were reversed, file descriptor 2 would 
be associated with the terminal (assuming file descriptor 1 had been) and file descriptor 1 would 
be associated with file xxx . 

If a command is followed by & then the default standard input for the command is the empty file 
/dev/null. Otherwise, the environment for the execution of a command contains the file descrip¬ 
tors of the invoking shell as modified by input/output specifications. 

Redirection of output is not allowed in the restricted shell. 

Environment 

The environment (see environij)) is a list of name-value pairs that is passed to an executed pro¬ 
gram in the same way as a normal argument list. The shell interacts with the environment in 
several ways. On invocation, the shell scans the environment and creates a parameter for each 
name found, giving it the corresponding value. Executed commands inherit the same environ¬ 
ment. If the user modifies the value of any of these parameters or creates new parameters, none 
of these affects the environment unless the export command is used to bind the shell’s parameter 
to the environment (see also set -a). A parameter may be removed from the environment with 
the unsetcommand. The environment seen by any executed command is thus composed of any 
unmodified name-value pairs originally inherited by the shell, minus any pairs removed by unset, 
plus any modifications or additions, all of which must be noted in export commands. 

The environment for any simple-command may be augmented by prefixing it with one or more 
assignments to parameters. Thus: 

TERM=450 cmd and 

(export TERM; TERM=450; cmd) 

are equivalent (as far as the execution of cmd is concerned). 

If the -k flag is set, all keyword arguments are placed in the environment, even if they occur after 
the command name. The following first prints a=:b c and then c: 

echo a=b c 
set -k 

echo a=b c 

Signals 

The INTERRUPT and QUIT signals for an invoked command are ignored if the command is fol¬ 
lowed by otherwise signals have the values inherited by the shell from its parent, with the 
exception of signal 11 (but see also the trap command below). 

Execution 

Each time a command is executed, the above substitutions are carried out. If the command name 
matches one of the Special Commands listed below, it is executed in the shell process. If the 
command name does not match a Special Command, but matches the name of a defined function, 
the function is executed in the shell process (note how this differs from the execution of shell pro¬ 
cedures). The positional parameters $1, $2, _ are set to the arguments of the function. If the 

command name matches neither a Special Command nor the name of a defined function, a new 
process is created and an attempt is made to execute the command via exec {2). 

The shell parameter PATH defines the search path for the directory containing the command. 
Alternative directory names are separated by a colon (:). The default path is :/bin;/usr/bin 
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(specifying the current directory, /bin, and /usr/bin, in that order). Note that the current 
directory is specified by a null path name, which can appear immediately after the equal sign or 
between the colon delimiters anywhere else in the path list. If the command name contains a / 
then the search path is not used; such commands will not be executed by the restricted shell. 
Otherwise, each directory in the path is searched for an executable file. If the file has execute 
permission but is not an a.out file, it is assumed to be a file containing shell commands. A sub¬ 
shell (i.e., a separate process) is spawned to read it. A parenthesized command is also executed in 
a sub-shell. 

The location in the search path where a command was found is remembered by the shell (to help 
avoid unnecessary execs later). If the command was found in a relative directory, its location 
must be re-determined whenever the current directory changes. The shell forgets all remembered 
locations whenever the PATH variable is changed or the hash -r command is executed (see 
below). 

Special Commands 

The following commands are executed in the shell process. Input/output redirection is permitted 
for these commands. File descriptor 1 is the default output location. 

: No effect; the command does nothing. A zero exit code is returned. 

. file Read and execute commands from file and return. The search path specified by PATH is 

used to find the directory containing file. Note that this command does not spawn 
another shell to execute file, and thus differs in behavior and output from executing file as 
a shell script, 
break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified then break n levels, 
continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n is specified then 
resume at the n-th enclosing loop, 
cd [ arg ] 

Change the current directory to arg. The shell parameter HOME is the default arg. The 
shell parameter CDPATH defines the search path for the directory containing arg. 
Alternative directory names are separated by a colon (:). The default path is <null> 
(specifying the current directory). Note that the current directory is specified by a null 
path name, which can appear immediately after the equal sign or between the colon del¬ 
imiters anywhere else in the path list. If arg begins with a / the search path is not used. 
Otherwise, each directory in the path is searched for arg. The cd command may not be 
executed by rsh. 
echo [ arg ... ] 

Echo arguments. See echo{l) for usage and description, 
eval [ arg ... ] 

The arguments are read as input to the shell and the resulting command(s) executed, 
exec [ arg ... ] 

The command specified by the arguments is executed in place of this shell without creat¬ 
ing a new process. Input/output arguments may appear and, if no other arguments are 
given, cause the shell input/output to be modified, 
exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is omitted then the exit 
status is that of the last command executed (an end-of-file will also cause the shell to 
exit.) 

export [ name ... ] 

The given names are marked for automatic export to the environment of subsequently- 
executed commands. If no arguments are given, then a list of all names that are exported 
in this shell is printed. Function names may not be exported. 
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hash [ -r ] [ name ... ] 

For each name, the location in the search path of the command specified by name is 
determined and remembered by the shell. The -r option causes the shell to forget all 
remembered locations. If no arguments are given, information about remembered com¬ 
mands is presented. Hits is the number of times a command has been invoked by the 
shell process. Cost is a measure of the work required to locate a command in the search 
path. There are certain situations which require that the stored location of a command 
be recalculated. Commands for which this will be done are indicated by an asterisk (*) 
adjacent to the hits information. Cost will be incremented when the recalculation is done, 
newgrp [ arg ... ] 

Equivalent to exec newgrp arg _ See newgrp (1) for usage and description. 

pwd Print the current working directory. See pwd(l) for usage and description, 
read [ name ... ] 

One line is read from the standard input and the first word is assigned to the first name, 
the second word to the second name, etc., with leftover words assigned to the last name. 
The return code is 0 unless an end-of-file is encountered. 

readonly [ name ... ] 

The given names are marked readonly and the values of the these names may not be 
changed by subsequent assignment. If no arguments are given, then a list of all readonly 
names is printed. 

return [ n ] 

Causes a function to exit with the return value specified by n. If n is omitted, the return 
status is that of the last command executed, 
set [ —aefhkntuvx [ arg .. • ] ] 

-a Mark variables which are modified or created for export. 

-e Exit immediately if a command exits with a non-zero exit status. 

-f Disable file name generation 

-h Locate and remember function commands as functions are defined (function com¬ 
mands are normally located when the function is executed). 

-k All keyword arguments are placed in the environment for a command, not just 
those that precede the command name. 

-n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-V Print shell input lines as they are read. 

-X Print commands and their arguments as they are executed. 

Do not change any of the flags; useful in setting $1 to -. 

Using + rather than - causes these flags to be turned off. These flags can also be used 
upon invocation of the shell. The current set of flags may be found in $-. The remaining 
arguments are positional parameters and are assigned, in order, to $ 1 , $ 2 , .... If no 
arguments are given then the values of all names are printed, 
shift [ n ] 

The positional parameters from $n+l ... are renamed $1 — If n is not given, it is 
assumed to be 1. 

test 

Evaluate conditional expressions. See test{l) for usage and description. Note that "[ ... ]" 
in an if list is interpreted the same as "test ...". There must be blanks around the 
brackets. 

times 

Print the accumulated user and system times for processes run from the shell, 
trap [ arg ] [ n ] ... 

The command arg is a command to be read and executed when the shell receives signal (s) 
n. (Note that arg is scanned once when the trap is set and once when the trap is taken.) 
Trap commands are executed in order of signal number. Any attempt to set a trap on a 
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signal that was ignored on entry to the current shell is ineffective. An attempt to trap on 
signal 11 (memory fault) produces an error. If arg is absent then all trap(s) n are reset to 
their original values. If arg is the null string then this signal is ignored by the shell and 
by the commands it invokes. If w is 0 then the command arg is executed on exit from the 
shell. The trap command with no arguments prints a list of commands associated with 
each signal number, 
type [ name ... ] 

For each name^ indicate how it would be interpreted if used as a command name, 
ulimit [ -fp ] [ n ] 

imposes a size limit of n 

-f imposes a size limit of n blocks on files written by child processes (files of any size 
may be read). With no argument, the current limit is printed. 

If no option is given, -f is assumed, 
umask [ nnn ] 

The user file-creation mask is set to nnn (see umask{2)). If nnn is omitted, the current 
value of the mask is printed, 
unset [ name ... ] 

For each name, remove the corresponding variable or function. The variables PATH, 
PSl, PS2, MAILCHECK and IFS cannot be unset, 
wait [ n ] 

Wait for the specified process and report its termination status. If n is not given, all 
currently active child processes are waited for and the return code is zero. 

Invocation 

If the shell is invoked through ea:ec(2) and the first character of argument zero is -, commands are 
initially read from /etc/profile and then from $HOME/.profile, if such files exist. Thereafter, 
commands are read as described below, which is also the case when the shell is invoked as 
/bin/sh. The flags below are interpreted by the shell on invocation only; Note that unless the -c 
or -s flag is specified, the first argument is assumed to be the name of a file containing commands, 
and the remaining arguments are passed as positional parameters to that command file: 

-c string If the -c flag is present then commands are read from string. 

-s If the -s flag is present or if no arguments remain then commands are read from the 

standard input. Any remaining arguments specify the positional parameters. Shell 
output (except for Special Commands) is written to file descriptor 2. 

“i If the -i flag is present or if the shell input and output are attached to a terminal, then 

this shell is interactive. In this case TERMINATE is ignored (so that kill 0 does not 
kill an interactive shell) and INTERRUPT is caught and ignored (so that wait is inter¬ 
ruptible). In all cases, QUIT is ignored by the shell. 

-r If the -r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described under the set command above. 

Rsh Only 

Rsh is used to set up login names and execution environments whose capabilities are more con¬ 
trolled than those of the standard shell. The actions of rsh are identical to those of sh, except 
that the following are disallowed: 

changing directory (see cd(l)), 

setting the value of $PATH, 

specifying path or command names containing /, 

redirecting output (> and >>). 

The restrictions above are enforced after .profile is interpreted. 

When a command to be executed is found to be a shell procedure, rsh invokes sh to execute it. 
Thus, it is possible to provide to the end-user shell procedures that have access to the full power 
of the standard shell, while imposing a limited menu of commands; this scheme assumes that the 
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end-user does not have write and execute permissions in the same directory. 

The net effect of these rules is that the writer of the .profile has complete control over user 
actions, by performing guaranteed setup actions and leaving the user in an appropriate directory 
(probably not the login directory). 

The system administrator often sets up a directory of commands (i.e., /usr/rbin) that can be 
safely invoked by rsh. Some systems also provide a restricted editor red. 

FILES 

/etc/profile 
$HOME/.profile 
/tmp/sh* 

/dev/null 

RETURN VALUE 

The error codes returned by the shell are: 

0 - success; 

1 - a built-in command failure (see Special Commands); 

2 - syntax error; 

3 - signal received that is not trapped. 

If the shell is non-interactive, it will terminate and pass one of the above as its exit status. If it is 
interactive, it will not terminate, but $? will be set to one of the above values. 

Whenever a child process of the shell dies due to a signal, the shell returns an exit status of 80 
hexadecimal + the number of the signal. 

SEE ALSO 

acctcms(lM), acctcom(l), cd(l), echo(l), env(l), login(l), newgrp(l), pwd(l), test(l), umask(l), 
dup(2), exec(2), fork(2), pipe(2), signal(2), ulimit(2), umask(2), wait(2), a.out(5), profile(5), 
environ (7). 

CAVEATS 

If a command is executed, and a command with the same name is installed in a directory in the 
search path before the directory where the original command was found, the shell will continue to 
exec the original command. Use the hash command to correct this situation. 

The shell assumes it is talking to terminals that only process the least significant seven bits of a 
character. If your terminal uses all eight bits, you may see some strange strings. 

When the shell encounters », it does not open the file in append mode. Instead, it opens the file 
for writing and seeks to the end. If you move the current directory or one above it, pwd may not 
give the correct response. Use the cd command with a full path name to correct this situation. 

The command readonly (without arguments) produces the same output as the command 

export. 
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NAME 

size - print section sizes of common object files 

SYNOPSIS 

size [ -o ] [ -X ] files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

The size command produces section size information for each section in common object files. The 
size of the text, data and bss (uninitialized data) sections are printed along with the total size of 

the object file. If an archive file is input to the size command the information for all archive 

members is displayed. 

By default, numbers are printed in decimal, unless altered by the options described below. 

-o print numbers in octal. 

-X print numbers in hexadecimal. 

HARDWARE DEPENDENCIES 
Series 500: 

The text size shown is the sum of the sizes of all code segments. 

The data size shown is the sum of the initialized portions of the ddata and idata segments 
(which may be one or two data segments). 

The bss size shown is the sum of the uninitialized portions of the ddata and idata seg¬ 
ments. 

If size is run on any commands shipped with HP-UX, the text size does not include any 
shared library segments referenced by the command. 

SEE ALSO 

as(l), cc(l), ld(l), a.out(5), ar(5). 

DIAGNOSTICS 

size: name: cannot open 

if name cannot be read. 

size: name: bad magic 

if name is not an appropriate common object file. 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a command after a certain 
amount of time, as in: 

(sleep 105; command)^, 
or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

SEE ALSO 

alarm(2), sleep(3C). 

BUGS 

Time must be less than 65536 seconds. 


Hewlett-Packard 


- 1 - 


July 2, 1985 



SLP(l) 


Series 200 Only 


SLP(l) 


NAME 

sip - set the options for a printer 
SYNOPSIS 

sip [-a] [-ccols] [-d] [-i indent] [-Hines] [-n] 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: Sip is implemented on the Series 200 only. 

DESCRIPTION 

Sip sets certain printer options for the device that is the current standard output. 

The meanings of the options are: 

-a Reports all of the option settings. 

-ccols The number of columns which are to be printed is indicated by the cols argument. 
Characters beyond the last specified column will be truncated. 

-d Resets options to the defaults for the device. (This action is not taken until the next 

open occurs on the device.) 

-i indent Indent selects the number of columns to indent before the first printed column. 

-1/mes The number of lines per page is set to lines. The last new-line character of each page 
will be changed to a form-feed. 

-n Set the page size to infinity. (Since the last new-line of the page is never encountered, 

no new-line characters will be changed to form-feeds.) 

EXAMPLES 

A typical case is to set the printer to 80 colunms, no indentation, and no form-feeds between 
pages: 

sip -c80 -iO -n >/dev/lp 

HARDWARE DEPENDENCIES 

Series 200: 

The value of cols will be forced into the range of 1 to 227, the value of indent from 0 to 227, 
and the value of lines from 1 to MAXSHORT. 

SEE ALSO 

ioctl(2), lp(4). 
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NAME 

sort - sort and/or merge files 

SYNOPSIS 

sort [ [-emu] [-ooutput] [-ykmem] [-zrecsz] [-dfilkMnr [-Llanguage] [-Ktablej] [-btx] [-fposl 
[-pos2]]] [files] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Native Language Support: 

8-bit and 16-bit data, customs, messages 

DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on the standard output. The 
standard input is read if - is used as a file name or no input files are named. 

Comparisons are based on one or more sort keys extracted from each line of input. By default, 
there is one sort key, the entire input line, and ordering is lexicographic by bytes in machine col¬ 
lating sequence. 

The following options alter the default behavior: 

-c Check that the input file is sorted according to the ordering rules; give no output unless the 
file is out of sort. 

-m Merge only, the input files are already sorted. 

-u Unique: suppress all but one in each set of lines having equal keys. 

-ooutput 

The argument given is the name of an output file to use instead of the standard output. 
This file may be the same as one of the inputs. There may be optional blanks between -o 
and output. 

-ykmem 

The amount of main memory used by the sort has a large impact on its performance. Sort¬ 
ing a small file in a large amount of memory is a waste. If this option is omitted, sort begins 
using a system default memory size, and continues to use more space as needed. If this 
option is presented with a value, fcmem, sort will start using that number of kilobytes of 
memory, unless the administrative minimum or maximum is violated, in which case the 
corresponding extremum will be used. Thus, -yO is guaranteed to start with minimum 
memory. By convention, -y (with no argument) starts with maximum memory. 

-zrecsz 

The size of the longest line read is recorded in the sort phase so buffers can be allocated 
during the merge phase. If the sort phase is omitted via the -c or -m options, a popular 
system default size will be used. Lines longer than the buffer size will cause sort to ter¬ 
minate abnormally. Supplying the actual number of bytes in the longest line to be merged 
(or some larger value) will prevent abnormal termination. 

The following options override the default ordering rules. 

-d “Dictionary” order: only letters, digits and blanks (spaces and tabs) are significant in com¬ 
parisons. 

-f Fold lower case into upper case, for purposes of comparison. 

-i Ignore characters outside the ASCII range 040-0176 in non-numeric comparisons. 

-M Compare as months. The first three non-blank characters of the field are folded to upper 
case and compared so that “JAN” < “FEB” < ... < “DEC”. Invalid field compare low to 
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“JAN”. The -M option implies the -b option (see below). 

-n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or 
more digits with optional decimal point, is sorted by arithmetic value. The -n option 
implies the -b option (see below). Note that the -b option is only effective when restricted 
sort key specifications are in effect. 

-r Reverse the sense of comparisons. 

The following two options apply to extended ASCII character sets. 

-1 Collate characters using the table associated with the user’s LANG variable (See 
environ[l)). 

-'Llanguage 

Allow the user to specify his/her local language. The -f and -1 options are to behave in a 
language dependent fashion, the -d, -i, -M and -n options are not. The language over¬ 
rides the LANG variable. 

The following two options apply to data containing 16-bit characters. 

-k 16-bit characters data appears in canonical 8-bit form. This option implies -b. If -K is 
not specified native machine collation is used. 

-Vitahle Name of a file which contains a 16-bit character set collation table as specified in 
nl—Colseq—16{b). 

When ordering options appear before restricted sort key specifications, the requested ordering 
rules are applied globally to all sort keys. When attached to a specific sort key (described below), 
the specified ordering options override all global ordering options for that key. 

The notation -\-posl -pos2 restricts a sort key to one beginning at posl and ending at pos2. The 
characters at positions posl and pos2 are included in the sort key (provided that pos2 does not 
precede posl). A missing -pos2 means the end of the line. 

Specifying posl and pos2 involves the notion of a field, a minimal sequence of characters followed 
by a field separator or a new-line. By default, the first blank (space or tab) of a sequence of 
blanks acts as the field separator. All blanks in a sequence of blanks are considered to be part of 
the next field; for example, all blanks at the beginning of a line are considered to be part of the 
first field. The treatment of field separators can be altered using the options: 

-tx Use a: as the field separator character; x is not considered to be part of a field (although it 
may be included in a sort key). Each occurrence of x is significant (e.g., xx delimits an 
empty field). 

-b Ignore leading blanks when determining the starting and ending positions of a restricted sort 
key. If the -b option is specified before the first -^posl argument, it will be applied to all 
-hposl arguments. Otherwise, the b flag may be attached independently to each -\-posl or 
-pos2 argument (see below). 

Posl and pos2 each have the form m,n optionally followed by one or more of the flags bdfinr. A 
starting position specified by +m.n is interpreted to mean the n+lst character in the m+lst 
field. A missing .n means .0, indicating the first character of the m+lst field. If the b flag is in 
effect n is counted from the first non-blank in the m+lst field; -f m*0b refers to the first non¬ 
blank character in the m+lst field. 

A last position specified by -m.n is interpreted to mean the nth character (including separators) 
after the last character of the m th field. A missing ,n means .0, indicating the last character of 
the mth field. If the b flag is in effect n is counted from the last leading blank in the m+lst field; 
-m.lb refers to the first non-blank in the m+lst field. 

When there are multiple sort keys, later keys are compared only after all earlier keys compare 
equal. Lines that otherwise compare equal are ordered with all bytes significant. 
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HARDWARE DEPENDENCIES 

Series 200/500: 16-bit collation currently is not supported. 

EXAMPLES 

Sort the contents of infile with the second field as the sort key: 
sort +1-2 infile 

Sort, in reverse order, the contents of infilel and infile2, placing the output in outfile and using 
the first character of the second field as the sort key: 

sort -r -o outfile +1.0 -1.2 infilel infile2 

Sort, in reverse order, the contents of infilel and infile2 using the first non-blank character of the 
second field as the sort key: 

sort -r +1.0b -1.1b infilel infile2 

Print the password file {passwd(^)) sorted by the numeric user ID (the third colon-separated 
field): 

sort -t: +2n -3 /etc/passwd 

Print the lines of the already sorted file infile ^ suppressing all but the first occurrence of lines hav¬ 
ing the same third field (the options -um with just one input file make the choice of a unique 
representative from a set of equal lines predictable): 

sort -um +2-3 infile 

FILES 

/usr/tmp/stm??? 

SEE ALSO 

comm(l), join(l), uniq(l), nl_col_seq_16(5), nl_col_seq_8(5), environ(7), hpnls(7), langid(7). 

DIAGNOSTICS 

Comments and exits with non-zero status for various trouble conditions (e.g., when input lines 
are too long), and for disorder discovered under the -c option. When the last line of an input file 
is missing a new-line character, sort appends one, prints a warning message, and continues. 

BUGS 

Sort does not understand "missing" fields. For example, consider a file with the following con¬ 
tents: 


Doe, John 

mailman 

17550 

8 

Spencer, Joe 

plumber 


4 

Johns,Ann 

secretary 

15950 


Malley,Dean 

engineer 

26750 

4 


You may get unexpected results if you try to sort on the third or fourth fields (all names and 
associated data are fictitious). 

Sort does not expand tabs when counting characters to locate a field. 

Sort does not perform "-fl" in which it would fold lower to upper, then compare in language- 
dependent sequence. Instead, it performs "-fl" as though it were "-1". 
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NAME 

spell, spellin, spellout - find spelling errors 

SYNOPSIS 

spell [ options ] [ files ] 

/usr/iib/spell/speilin [ list ] 

/usr/lib/spell/spellout [ -d ] list 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Spell collects words from the named files and looks them up in a spelling list. Words that neither 
occur among nor are derivable (by applying certain inflections, prefixes, and/or suffixes) from 
words in the spelling list are printed on the standard output. If no files are named, words are 
collected from the standard input. 

Spell ignores most nroff{l), and tbl constructions. 

The options are: 

-V all words not literally in the spelling list are printed, and plausible derivations 
from the words in the spelling list are indicated. 

-b British spelling is checked. Besides preferring centre^ colour, speciality, travelled, 
etc., this option insists upon -ise in words like standardise, Fowler and the OED 
to the contrary notwithstanding. 

-X every plausible stem is printed with = for each word. 

The spelling list is based on many sources, and while more haphazard than an ordinary diction¬ 
ary, is also more effective with respect to proper names and popular technical words. Coverage of 
the specialized vocabularies of biology, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated below with their default 
settings. Copies of all output are accumulated in the history file. The stop list filters out 
misspellings (e.g., thier=thy-y+ier) that would otherwise pass. 

Two routines help maintain the hash lists used by spell (both expect a list of words, one per line, 
from the standard input): 

spellin adds the words on the standard input to the pre-existing list and places 

a new list on the standard output. If no list is specified, the new list is 
created from scratch. 

Spellout looks up each word read from the standard input, and prints on the stan¬ 

dard output those that are missing from (or, with the -d option, present 
in) the hash list. 

HARDWARE DEPENDENCIES 
Series 200/500: 

eqn, typo and troff Sire not currently supported. 


FILES 

D_SPELL=/usr/lib / spell/hlist [ab] 
S_SPELL=/usr/lib/spell/hstop 
H_SPELL=/usr/lib / spell/spellhist 
/tmp/spell.$$ 

/ usr/lib / spell / spellprog 


hashed spelling lists, American &; British 

hashed stop list 

history file 

temporary 

program 
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SEE ALSO 

deroff(l), nroff(l), sed(l), sort(l), tbl(l), tee(l). 

BUGS 

The spelling list’s coverage is uneven; new installations will probably wish to monitor the output 
for several months to gather local additions; typically, these are kept in a separate local dictionary 
that is added to the hashed list via spellin. 

British spelling was done by an American. 
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NAME 

split - split a file into pieces 

SYNOPSIS 

split [ -w ] [ file [ name ] ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Split reads file and writes it in n-line pieces (default 1000 lines) onto a set of output files. The 
name of the first output file is name with aa appended, and so on lexicographically, up to zz (a 
maximum of 676 files). Name cannot be longer than 12 characters. If no output name is given, x 
is default. 

If no input file is given, or if - is given instead, then the standard input file is used. 

SEE ALSO 

bfs(l), csplit(l). 
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NAME 

ssp - remove multiple line-feeds from output 

SYNOPSIS 

ssp 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Ssp (single-space) removes redundant blank lines from the standard input and sends the result to 
the standard output. It is typically used in pipelines like 

nroff -ms filel I ssp 

Ssp is equivalent the the 4.2BSD cat -s command. 

SEE ALSO 

cat(l), rmnl(l). 
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NAME 

strings - find the printable strings in a object, or other binary, file 

SYNOPSIS 

strings [ -a ] [ -o ] [ -number ] [ file ] ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Strings looks for ascii strings in a file. If no files, are specified, stdin is used. A string is any 
sequence of 4 or more printing characters ending with a new-line or a null. 

The following fiags are defined. 

a By default, strings only looks in the initialized data space of object files (as recognised by 

their magic numbers). If this flag is used, the whole file is inspected. This flag is always 
set if stdin is being read or the file is not recognized as an object file. For backward 
compatability, - is taken as a synonym for -a. 

o Each string is preceded by its offset in the file (in octal). 

number number is used as the minimum string length rather than 4. 

Strings is useful for identifying random object files and many other things. 

SEE ALSO 

od(l) 

BUGS 

The algorithm for identifying strings is extremely primitive. 
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NAME 

strip - remove symbols and debug information 

SYNOPSIS 

strip name ... 

HP-UX COMPATIBILITY 

Level: HP-UX/DEVELOPMENT 

Origin: System V 

DESCRIPTION 

Strip removes the symbol table and debug information from an executable object file. Once this is 
done, no symbolic debugging access will be available for that file; therefore this command is nor¬ 
mally run only on production modules that have been debugged and tested. The effect is the 
same as use of the -s option of Id. 

If name is a relocatable file, strip removes the debug information. 

If the strip command is executed on an archive file (see ar (5)) the archive symbol table will be 
removed. The archive symbol table must be restored by executing the ar (1) command with the s 
option before the archive can be link-edited by the Id (1) command. Also, strip removes the debug 
information from any a. out file it finds in the archive. 

The purpose of this command is to reduce the file storage overhead taken by the object file. 

HARDWARE DEPENDENCIES 

Series 200: 

If name is a relocatable file, strip will remove the local symbols from it. If name is an 
archive file, strip will remove the local symbols from any a. out format files it finds in the 
archive. Certain libraries, such as those residing in /lib, have no need for local symbols. 
By deleting them, the size of the archive is decreased and link editing performance is 
increased. 

FILES 

/tmp/s* temporary files 

SEE ALSO 

ar(l), ld(l), ar(5), a.out(5). 
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NAME 

stty - set the options for a terminal port 

SYNOPSIS 

stty [ -a ] [ -g ] [ options ] 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System III 

DESCRIPTION 

Stty sets certain terminal I/O options for the device that is the current standard input; without 
arguments, it reports the settings of certain options; with the -a option, it reports all of the option 
settings; with the -g option, it reports current settings in a form that can be used as an argument 
to another stty command. Detailed information about the modes listed in the first five groups 
below may be found in termio{4) for asynchronous lines. Options in the last group are imple¬ 
mented using options in the previous groups. Note that many combinations of options make no 
sense, but no sanity checking is performed. The options are selected from the following: 

Control Modes 

parenb (-parenb) enable (disable) parity generation and detection. 

parodd (-parodd) select odd (even) parity. 

cs5 cs6 cs7 cs8 select character size (see termio{4:)). 

0 hang up phone line immediately. 

50 75 110 134.5 150 200 300 600 900 1200 

1800 2400 3600 4800 7200 9600 19200 38400 exta extb 

Set terminal baud rate to the number given, if possible. (All speeds are not 
supported by all hardware interfaces.) 

hupcl (-hupcl) hang up (do not hang up) modem connection on last close. 

hup (-hup) same as hupcl (-hupcl). 

cstopb (-cstopb) use two (one) stop bits per character. 

cread (-cread) enable (disable) the receiver. 

crts (-crts) enable (disable) request-to-send. 

clocal (-clocal) assume a line without (with) modem control. 

Input Modes 

ignbrk (-ignbrk) ignore (do not ignore) break on input. 

ienqak (-ienqak) enable (disable) ENQ-ACK handshaking. 

brkint (-brkint) signal (do not signal) INTR on break. 

ignpar (-ignpar) ignore (do not ignore) parity errors. 

parmrk (-parmrk) mark (do not mark) parity errors (see termio{4)). 

inpck (-inpck) enable (disable) input parity checking. 

istrip (-istrip) strip (do not strip) input characters to seven bits. 

inlcr (-inlcr) map (do not map) NL to CR on input. 

igncr (-igncr) ignore (do not ignore) CR on input. 

icrnl (-icrnl) map (do not map) CR to NL on input. 

iuclc (-iuclc) map (do not map) upper-case alphabetics to lower case on input. 

ixon (-ixon) enable (disable) START/STOP output control. Output is stopped by send¬ 

ing an ASCII DC3 and started by sending an ASCII DCl. 
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ixany (-ixany) 
ixoff (-ixoff) 

Output Modes 
opost (-opost) 

olcuc (-olcuc) 
onlcr (-onlcr) 
ocrnl (-ocrnl) 
onocr (-onocr) 
onlret (-onlret) 
ofill (-ofill) 
ofdel (-ofdel) 
crO crl cr2 cr3 
nlO nil 


allow any character (only DCl) to restart output. 

request that the system send (not send) START/STOP characters when the 
input queue is nearly empty/full. 

post-process output (do not post-process output; ignore all other output 
modes). 

map (do not map) lower-case alphabetics to upper case on output, 
map (do not map) NL to CR-NL on output, 
map (do not map) CR to NL on output, 
do not (do) output CRs at column zero. 

on the terminal NL performs (does not perform) the CR function, 
use fill characters (use timing) for delays, 
fill characters are DELs (NULs). 

select style of delay for carriage returns (see termio{4:)). 
select style of delay for line-feeds (see termio{4:)). 


tabO tabl tab2 tab3 


bsO bsl 
ffO ffl 
vtO vtl 

Local Modes 
isig (-isig) 


select style of delay for horizontal tabs (see termio (4). 
select style of delay for backspaces (see ^erm^o(4)). 
select style of delay for form-feeds (see termio[4)). 
select style of delay for vertical tabs (see termio{4)). 

enable (disable) the checking of characters against the special control char¬ 
acters INTR and QUIT. 


icanon (-icanon) 
xcase (-xcase) 
echo (-echo) 
echoe (-echoe) 


echok (-echok) 
Ifkc (-Ifkc) 
echonl (-echonl) 
noflsh (-noflsh) 

Control Assignments 

control-character c 


enable (disable) canonical input (ERASE and KILL processing). 
canonical (unprocessed) upper/lower-case presentation, 
echo back (do not echo back) every character typed. 

echo (do not echo) ERASE character as a backspace-space-backspace 
string. Note: this mode will erase the ERASEed character on many CRT 
terminals; however, it does not keep track of column position and, as a 
result, may be confusing on escaped characters, tabs, and backspaces. 

echo (do not echo) NL after KILL character, 
the same as echok (-echok); obsolete, 
echo (do not echo) NL. 
disable (enable) flush after INTR or QUIT. 

set control-character to c, where control-character is erase, kill, intr, 
quit, swtch, eof, min, or time (min and time are used with -icanon; 
see termio{4)). If c is preceded by an (escaped from the shell) caret ("), 
then the value used is the corresponding CTRL character (e.g., “"d” is a 
CTRL—d); is interpreted as DEL and is interpreted as 

undefined. 
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line i set line discipline to i (0 < ^ < 127 ). (See ^erm^o(4)). 

Combination Modes 

evenp or parity enable parenb and cs7. 
oddp enable parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

disable parenb, and set cs8. 

raw (-raw or cooked) 

enable (disable) raw input and output (no ERASE, KILL, INTR, QUIT, EOT, 
or output post processing). 

unset (set) icrnl, onlcr. In addition -nl unsets inlcr, igncr, ocrnl, and 
onlret. 

set (unset) xcase, iuclc, and olcuc. 
same as lease (-lease). 

preserve (expand to spaces) tabs when printing, 
reset ERASE and KILL characters back to normal # and 
resets all modes to some reasonable values. 

set all modes suitable for the terminal type term, where term is one of 

tty33, tty37, vt05, tn300, ti700, hp, 

HARDWARE DEPENDENCIES 

Series 200/500: 

Refer to termio{4) for a description of the capabilities that are not supported. 

SEE ALSO 

tabs(l), ioctl(2), termio(4). 


nl (-nl) 

lease (-lease) 

LCASE (-LCASE) 

tabs (-tabs or tab3) 

ek 

sane 

term 
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NAME 

su - become super-user or another user 

SYNOPSIS 

su [ - ] [ name [ arg •.. ] ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Su allows one to become another user without logging off. The default user name is root (i.e., 
super-user), 

To use su, the appropriate password must be supplied (unless one is already root). If the pass¬ 
word is correct, su will execute a new shell with the real and effective user ID, real and effective 
group ID, and group access list set to that of the specified user. The new shell will be the optional 
program named in the shell field of the specified user’s password file entry (see passwd(4)), or 
/bin/sh if none is specified (see s/i(l)). To restore normal user ID privileges, type an EOF to the 
new shell. 

Any additional arguments given on the command line are passed to the program invoked as the 
shell, permitting the super-user to run shell procedures with restricted privileges. When using 
programs like sh{l), an arg of the form -c string executes string via the shell and an arg of -r will 
give the user a restricted shell. 

The following statements are true only if the optional program named in the shell field of the 
specified user’s password file entry is like sh(l). If the first argument to is a -, the environment 
will be changed to what would be expected if the user actually logged in as the specified user. 
This is done by invoking the program used as the shell with an argO value whose first character is 
-, thus causing first the system’s profile (/etc/profile) and then the specified user’s profile 
(.profile in the new HOME directory) to be executed. Otherwise, the environment is passed 
along unchanged, except that $PATH, is unconditionally set to /bin:/etc:/usr/bin for root. 
Note that if the optional program used as the shell is /bin/sh, the user’s .profile can check argO 
for -sh or -su to determine if it was invoked by login{l) or su{l), respectively. If the user’s pro¬ 
gram is other than /bin/sh, then .profile is invoked with an argO of -program by both login{l) 
and su{l). 

The - option always resets $PATH to /bin:/etc:/usr/bin for the super-user, and 
/bin:/usr/bin for all others. However, the files /etc/profile and .profile are normally executed 
anyway, thus restoring the intended value of $PATH. 

All attempts to become another user are logged in /usr/adm/sulog, including failures. Successful 
attempts are flagged with failures with 

EXAMPLES 

To become user bin while retaining your previously exported environment, execute: 
su bin 

To become user bin but change the environment to what would be expected if bin had originally 
logged in, execute: 

su - bin 

To execute command with the temporary environment and permissions of user bin, type: 
su - bin -c "command args" 
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FILES 

/etc/passwd system’s password file 

/etc/logingroup system’s default group access list file 

/etc/profile system’s profile 

SHOME/.profile user’s profile 

/usr/adm/sulog log of all attempts 

VARIABLES 

HOME the user’s home directory 

LOGNAME the user’s login name 

PATH the command name search path 

PSl the default prompt 

SHELL the name of the user’s shell 


HARDWARE DEPENDENCIES 

Multiple groups are not currently supported on Series 500 and the Integral PC. 

SEE ALSO 

env(l), login(l), sh(l), initgroups(3C), group(5), passwd(5), profile(5), environ(7). 
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NAME 

sum - print checksum and block count of a file 

SYNOPSIS 

sum [ -r ] [ file ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of 
512-byte blocks in the file. St din is used if no file names are given. Sum is typically used to look 
for bad spots, or to validate a file communicated over some transmission line. The option -r 
causes an alternate algorithm to be used in computing the checksum. 

SEE ALSO 

wc(l). 

DIAGNOSTICS 

“Read error” is indistinguishable from end of file on most devices; check the block count. 
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NAME 

sync - update the super block 

SYNOPSIS 

sync 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Sync executes the sync system intrinsic. If the system is to be stopped, sync must be called to 
insure file system integrity. It will flush all previously unwritten system buffers out to disk, thus 
assuring that all file modifications up to that point will be saved. See sync{2) for details. 

SEE ALSO 

sync(2). 

REDUCED SEMANTICS 

If sync(2) is a no-op and the system is RUN ONLY or NUCLEUS, the sync command need not 
be present. 
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NAME 

tabs - set tabs on a terminal 

SYNOPSIS 

tabs [ tabspec ] [ +mn ] [ -Ttype ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Tabs sets the tab stops on the user’s terminal according to the tab specification tabspec, after 
clearing any previous settings. The user’s terminal must have remotely-settable hardware tabs. 

If you are using a non-HP terminal, you should keep in mind that behavior will vary for some tab 
settings. 

Four types of tab specification are accepted for tabspec: “canned,” repetitive, arbitrary, and file. 
If no tabspec is given, the default value is -8, i.e., HP-UX “standard” tabs. The lowest column 
number is 1. Note that for tabs, column 1 always refers to the leftmost column on a terminal, 
even one whose column markers begin at 0. 

-code Gives the name of one of a set of “canned” tabs. The legal codes and their meanings are 
as follows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 
-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 

COBOL, normal format 
-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using this code, the first typed 
character corresponds to card column 7, one space gets you to column 8, and a tab 
reaches column 12. Files using this tab setup should include a format specification 
as follows: 

<:t-c2 m6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with more tabs than -c2. This is 
the recommended format for COBOL. The appropriate format specification is: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 
FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 
PL/I 

-s 1,10,55 
SNOBOL 
-u 1,12,20,44 

UNIVAC 1100 Assembler 

In addition to these “canned” formats, three other types exist: 

-n A repetitive specification requests tabs at columns 1-l-n, l+2*n, etc. Of particular 
importance is the value -8: this represents the HP-UX “standard” tab setting, and is the 
most likely tab setting to be found at a terminal. It is required for use with the nroff{l) 
-h option for high-speed output. Another special case is the value -0, implying no tabs 
at all. 

nl,n2,... The arbitrary format permits the user to type any chosen set of numbers, separated by 
commas, in ascending order. Up to 40 numbers are allowed. If any number (except the 
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first one) is preceded by a plus sign, it is taken as an increment to be added to the previ¬ 
ous value. Thus, the tab lists 1,10,20,30 and 1,10,+10,+10 are considered identical. 

—file If the name of a file is given, tabs reads the first line of the file, searching for a format 
specification. If it finds one there, it sets the tab stops according to it, otherwise it sets 
them as -8. This type of specification may be used to make sure that a tabbed file is 
printed with correct tab settings, and would be used with the pr{l) command: 
tabs — file; pr file 

Any of the following may be used also; if a given fiag occurs more than once, the last value given 
takes effect: 


-Ttype Tabs usually needs to know the type of terminal in order to set tabs and always needs to 

know the type to set margins. Type is a name listed in term{7). If no -T fiag is sup¬ 

plied, tabs searches for the $TERM value in the environment (see environij)). If no 
type can be found, tabs tries a sequence that will work for many terminals. 

+mn The margin argument may be used for some terminals. It causes all tabs to be moved 

over n columns by making column n+1 the left margin. If +m is given without a value 

of n, the value assumed is 10. The normal (leftmost) margin on most terminals is 
obtained by +m0. The margin for most terminals is reset only when the H-m flag is 
given explicitly. 

Tab and margin setting is performed via the standard output. 


DIAGNOSTICS 

illegal tabs 
illegal increment 
unknown tab code 
can’t open 
file indirection 


when arbitrary tabs are ordered incorrectly. 

when a zero or missing increment is found in an arbitrary specification, 
when a “canned” code cannot be found, 
if “ file option used, and file can’t be opened. 

if —file option used and the specification in that file points to yet another file. 
Indirection of this form is not permitted. 


SEE ALSO 

pr(l), nroff(l), tset(l), environ(7), term(7). 

BUGS 

There is no consistency among different terminals regarding ways of clearing tabs and setting the 
left margin. 

It is generally impossible to usefully change the left margin without also setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), but is willing to set 64. 
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NAME 

tail - deliver the last part of a file 

SYNOPSIS 

tail [ ± [number] [lbc[f] ] ] [ file ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Tail copies the named file to the standard output beginning at a designated place. If no file is 
named, the standard input is used. 

Copying begins at distance number from the beginning, or -number from the end of the input (if 
number is null, the value 10 is assumed). Number is counted in units of lines, blocks, or charac¬ 
ters, according to the appended option 1, b, or c. When no units are specified, counting is by 
lines. 

With the -f (“follow”) option, if the input file is not a pipe, the program will not terminate after 
the line of the input file has been copied, but will enter an endless loop, wherein it sleeps for a 
second and then attempts to read and copy further records from the input file. Thus it may be 
used to monitor the growth of a file that is being written by some other process. 

EXAMPLES 

Tail accepts at most two arguments: the first consists of specified options, and the second specifies 
the file of interest. If the number and f options are both desired, they must be concatenated to 
create a single option argument, as follows: 

tail -31f John 

This example prints the last three lines in the file john to the standard output, and leaves tail in 
"follow" mode. 

If only the f option is desired, it must be preceded by a -, as follows: 
tail -f fred 

This example prints the last ten lines of the file fred, followed by any lines that are appended to 
fred between the time tail is initiated and killed. Note that this output may build up very 
quickly for rapidly changing input files, perhaps too fast to read on a CRT. 

As another example, the command: 
tail -15cf fred 

will print the last 15 characters of the file fred, followed by any lines that are appended to fred 
between the time tail is initiated and killed. 

The + option starts at the number indicated from the beginning of the file (rather than skipping 
the number of units indicated and then starting). For example: 
tail +lb fred 

prints the entire contents of the file fred. 

SEE ALSO 

head(l). 

BUGS 

Tails relative to the end of the file are stored in a buffer, and thus are limited in length. Thus, be 
wary of the results when piping output from other commands into tail. 

Various kinds of anomalous behavior may happen with character special files. 

Tail can pick up a maximum of 4K bytes of data from the specified file. 
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NAME 

tar - tape file archiver 

SYNOPSIS 

tar [key] [ [ file \ -C directory ] ... ] 

HP-UX COMPATIBILITY 

Level: HP-UX/DEVELOPMENT 

Origin: System III and UCB 

Native Language Support: 

8-bit filenames. 


DESCRIPTION 

Tar saves and restores files on magnetic tape or flexible disc. Its actions are controlled by the key 
argument. The key is a string of characters containing at most one function letter and possibly 
one or more function modifiers. The key string may be preceded by a dash (-) (similar to the way 
options are specified in other HP-UX commands), but it is not necessary. Other arguments to 
the command are files (or directory names) specifying which files are to be dumped or restored. 
In all cases, appearance of a directory name refers to the files and (recursively) subdirectories of 
that directory. 

The function portion of the key is specified by one of the following letters: 

r The named files are added to the end of the archive. The c function implies this func¬ 

tion. 

X The named files are extracted from the archive. If a named file matches a directory 

whose contents had been written onto the archive, this directory is (recursively) 
extracted. If a named file on tape does not exist on the system, the file is created as fol¬ 
lows: 

The user, group, and other protections are restored from the tape. 

The modification time is restored from the tape unless the m option is specified. 
The file owner and group owner are normally that of the restoring process. 

The set-user-ID, set-group-ID and sticky bits are normally not set. The o and 
p options control the restoration of protection; see below for more details. 

If the files exist, their modes are not changed except that the set-user-ID, set-group-ID 
and sticky bits are cleared. If no files argument is given, the entire content of the 
archive is extracted. Note that if several files with the same name are on the archive, 
the last one overwrites all earlier ones. 

t The names of all the files on the archive are listed. Adding the v option will expand this 

listing to include the file modes and owner numbers. The names of all files are listed 
each time that they occur on the tape. 

u The named files are added to the archive if they are not already there, or have been 

modified since last written on that archive. 

c Create a new archive; writing begins at the beginning of the archive, instead of after the 

last file. This command implies the r function. 

The following function modifiers may be used in addition to the function letters listed above: 

#s Where # is a tape drive number (0,,,,,7), and s is the density (1 - low (800 bpi), m - 
medium (1600 bpi), or h - high (6250 bpi)). This modifier selects the drive on which the 
9 track tape is mounted. The default is Om. 

V Normally, tar does its work silently. The v (verbose) option causes it to type the name 

of each file it treats, preceded by the function letter. With the t function, v gives more 
information about the tape entries than just the name, 
w Causes tar to print the action to be taken, followed by the name of the file, and then 

wait for the user’s confirmation. If a word beginning with y is given, the action is per¬ 
formed. Any other input means “no”. 
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f Causes tar to use the next argument as the name of the archive instead of 

/dev/rmt/??. If the name of the file is tar writes to the standard output or reads 
from the standard input, whichever is appropriate. Thus, tar can be used as the head or 
tail of a pipeline. Tar can also be used to move hierarchies with the command: 

cd fromdir; tar cf - . [ (cd todir; tar xf -) 

b Causes tar to use the next argument as the blocking factor for archive records. If both f 

and b modifiers are specified, their arguments must match the order in which they are 
specified. This option should only be used when a blocking factor other than 1 is 
desired. The default is 1 (512 bytes) and the maximum is 20. The block size is deter¬ 
mined automatically when reading 9 track tapes (key letters x and t). The blocking fac¬ 
tor must be specified when reading flexible discs and cartridge tapes if they were written 
with a blocking factor different than the default. 

1 Tells tar to complain if it cannot resolve all of the links to the files being dumped. If 1 is 

not specified, no error messages are printed. 

m Tells tar to not restore the modification time written on the archive. The modification 

time of the file will be the time of extraction. 

h Forces tar to follow symbolic links as if they were normal files or directories. Normally, 

tar does not follow symbolic links. Not all HP-UX systems support symbolic links, 
o For writing: 

This option suppresses writing certain directory information that older versions of tar 
cannot handle on input. Tar normally writes information specifying owners and modes 
of directories in the archive. Former versions of tar, when encountering this information, 
will give error message of the form 
"<name>/: cannot create". 

This option will suppress writing that information. 

For reading: 

Causes extracted files to take on the user and group identifier of the user running the 
program rather than those on the tape. This is the default for the ordinary user, and 
may be overridden, to the extent the system protections allow, by the p option, 
p This option causes files to be restored to the original modes and ownerships written on 

the archive, if possible. This is the default for the super-user, and may be overridden by 
the o option. For the ordinary used, if the system protections forbid the chown{2) 
operation needed to do this, the error will be ignored, and the ownership left with the 
restoring process. Set-user-ID, set-group-ID and sticky information will be restored as 
allowed by the protections defined by chmod(2), if the chown operation above succeeded. 

The following option may be included in the file list: 

-Cdirectory tar will perform a chdir{2) to directory. This allows multiple directories not 
related by a close common parent to be archived using short relative path names. 

If a 9 track tape drive is used as the output device, it must be configured in Berkeley compatabil- 
ity mode; see m^(4). 

EXAMPLES 

tar cvf /dev/rfd.O filel file2 

This example creates a new archive on /dev/rfd.O and copies filel and file2 onto it, using a block¬ 
ing factor of 20. The key is made up of one function letter (c) and two function modifiers (v, and 

f). 

tar cv -C /usr include -C / etc 
This example archives files from /usr/include and from /etc. 

FILES 

/dev/rmt/* 
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/dev/rfd.* 

/tmp/tar* 

SEE ALSO 

ar(l), cpio(l), mt(4). 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write errors. 

Complaints if enough memory is not available to hold the link tables. 

BUGS 

There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

If the archive is on a flexible disc or cartridge tape, and if the blocking factor specified on output 
was not the default, the same blocking factor must be specified on input. This is because the 
blocking factor is not explicitly stored on the archive. Not following this rule and updating the 
archive can destroy it. 

The current limit on file-name length is 100 characters. 

Some previous versions of tar have claimed to support selective listing of file names using the t 
option with a list. To our knowledge this was an error in the documentation and does not appear 
in the original source code. 

There is no way to restore an absolute path name to a relative position. 

Archives should never be created on block special devices (e.g., /dev/fd.o). 

Tar always pads information written to an archive up to the next multiple of the block size. 
Therefore, if you are creating a small archive and write out one block of information, tar reports 
that one block was written, but the actual size of the archive may be larger if the b option was 
used. 

Note that tar cOm is not the same as tar cmO. 
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NAME 

tbl - format tables for nroff 

SYNOPSIS 

tbl [ -TX 1 [ files ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Tbl is a preprocessor that formats tables for nroff{l). The input files are copied to the standard 
output, except for lines between .TS and .TE command lines, which are assumed to describe 
tables and are re-formatted by tbl. (The .TS and .TE command lines are not altered by tbl). 

.TS is followed by global options. The available global options are: 

center center the table (default is left-adjust); 
expand make the table as wide as the current line length; 
box enclose the table in a box; 

doublebox 

enclose the table in a double box; 
allbox enclose each item of the table in a box; 

tab (x) use the character x instead of a tab to separate items in a line of input data. 

The global options, if any, are terminated with a semi-colon (;). 

Next come lines describing the format of each line of the table. Each such format line describes 
one line of the actual table, except that the last format line (which must end with a period) 
describes all remaining lines of the table. Each column of each line of the table is described by a 
single key-letter, optionally followed by specifiers that determine the font and point size of the 
corresponding item, that indicate where vertical bars are to appear between columns, that deter¬ 
mine column width, inter-column spacing, etc. The available key-letters are: 

c center item within the column; 

r right-adjust item within the column; 

1 left-adjust item within the column; 

n numerically adjust item in the column: units positions of numbers are aligned 

vertically; 

s span previous item on the left into this column; 

a center longest line in this column and then left-adjust all other lines in this 

column with respect to that centered line; 
span down previous entry in this column; 

_ replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 

The characters B and I stand for the bold and italic fonts, respectively; the character | indicates a 
vertical line between columns. 

The format lines are followed by lines containing the actual data for the table, followed finally by 
.TE. Within such data lines, data items are normally separated by tab characters. 

If a data line consists of only _ or =, a single or double line, respectively, is drawn across the 

table at that point; if a single item in a data line consists of only _ or =, then that item is 

replaced by a single or double line. 

Full details of all these and other features of tbl are given in the reference manual cited below. 

The -TX option forces tbl to use only full vertical line motions, making the output more suitable 

for devices that cannot generate partial vertical line motions (e.g., line printers). 
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If no file names are given as arguments (or if - is specified as the last argument), thl reads the 
standard input, so it may be used as a filter. When it is used with ne^n(l), neqn^ tbl should come 
first to minimize the volmne of data passed through pipes. 

EXAMPLE 

If we let <tab> represent a tab (which should be typed as a genuine tab), then the input: 

.TS 

center box ; 
cB s s 
cl I cl s 
" I c c 
1 I n n . 

Household Population 

Town<tab>Households 

<tab>Number<tab>Size 

Bedminster<tab>789<tab>3.26 
Bernards Twp.<tab>3087<tab>3.74 
Bernardsville<tab>2018<tab>3.30 
Bound Brook<tab>3425<tab>3.04 
Bridgewater<tab>7897<tab>3.81 
Far Hills<tab>240<tab>3.19 
.TE 

yields: 


Household 

Population 

Town 

Households 
Number Size 

Bedminster 

789 

3.26 

Bernards Twp. 

3087 

3.74 

Bernardsville 

2018 

3.30 

Bound Brook 

3425 

3.04 

Bridgewater 

7897 

3.81 

Far Hills 

240 

3.19 


SEE ALSO 

tbl Tutorial in the HP-UX Concepts and Tutorials. 

cw(l), eqn(l), mm(l), mmt(l), neqn(l), nroff(l), mm(5), mv(5), troff(l). 

BUGS 

See BUGS under nroff{l). 
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NAME 

tcio - Command Set 80 Cartridge Tape Utility 

SYNOPSIS 

tcio -o[dervV] [ -S buffersize ] [ -1 number ] [ -n limit ] filename 
tcio -i[drv] [ -S buffersize ] [ -1 number ] [ -n limit ] filename 
tcio -u[rvV] [ -m blocknumber ] [ -1 number ] filename 

HP-UX COMPATIBILITY 

Level; HP-UX/NON-STANDARD 

Origin: HP 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Tcio is an effective utility for optimizing the data transfer rate between a cartridge tape unit and 
the host processor. When used in conjunction with other utilities such as cpzo, a significant 
improvement in transfer efficiency results while simultaneously reducing wear and tear on tape 
cartridges. When used with autochanger mechanisms, tcio can load a specified cartridge or 
automatically switch to successive cartridges as needed. The tcio utility option supports functions 
that are unique to cartridge tape operations. 

Tcio -0 (copy out) reads the standard input and writes the data to the raw CS/80 Cartridge 
Tape Unit associated with the special file filename. 

Tcio -i (copy in) reads from the CS/80 Cartridge Tape Unit associated with the special file 
filename in raw mode and writes the data to the standard output. 

Tcio -u (utility option) performs utility functions on the cartridge tape, such as release, mark, 
and/or verify the cartridge. 

In all cases, filename must refer to a character (raw) special file associated with a CS/80 car¬ 
tridge tape unit. 

Tcio input and output (read/write) operations enable immediate report which can yield a 
significant increase in the tape performance (see BACKGROUND INFORMATION in this section for 
details). In addition, tcio puts a tape mark in the first block on each tape to prevent the tape 
from being image restored over a disc. A flag is also placed in the last block on each tape to iden¬ 
tify whether the tape is the last tape in a multiple-tape sequence. 

The following command options are recognized. At least one option, -o, -i, or -u must be 
specified. Additional options can be specified in any order, but all must precede the file name. 
Options without parameters can be listed individually or grouped together. Options with parame¬ 
ters require the parameter, and must be listed individually. Available modifiers and their mean¬ 
ings are: 

-v Verbose mode; prints information and error messages to stderr. 

-d Prints a checksum to stderr. The checksum is a 32-bit unsigned addition of the bytes in the 
data stream, thus providing an extra data integrity check in addition to tape verification. 
The checksum value is reported to the user, but it is not written on the media. It is up to 
the user to manually record and verify it. The checksum is valid only if the same number of 
bytes are read from the tape as were written to it. This option is independent of the verbose 
modifier. 

-e Applies only to output operation, and causes a tape mark to be written on the nearest 1024- 
byte boundary following the end of the data. When a tape containing an end-of-data tape 
mark is read back, the read terminates upon encountering the tape mark. When this option 
is used, checksums generated by corresponding input and output operations always agree. 

-V This option disables tape verification. Newer cartridge tape units using the HP 9144 drive 
provide hardware for verifying output data as it is written on the tape (called read-while- 
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write). This improves the integrity of recorded data as it is written on tape. HP 
7908/11/12/14 drives do not have re ad-while-write verification hardware, so they require a 
separate verification operation after writing. This option should not be used with such units. 

—r Releases the tape from the drive. On autochanger units, the tape is returned to the maga¬ 
zine. 

-S [ buffersize ] 

Enables specification of buffer size. This option forces the allocation of a block of memory to 
be used in reading or writing the tape. The buffer size in bytes is 1024 times the value 
specified for buffersize. A buffersize less than 4 or greater than 512 causes the program to 
terminate. If buffersize is not specified, tcio allocates a 64-Kbyte buffer. On tape units such 
as an HP 9144A or 7942/6 that support immediate report, a significant performance increase 
can sometimes be obtained by using smaller buffer sizes. For instance, if tcio is used as part 
of a pipeline, an appropriate buffer size is 8 (see BACKGROUND INFORMATION for further 
details). 

—m [ blocknumber ] 

This option writes a tape mark on a tape at the specified block. If a tape is created by some 
means other than tcio, a tape mark in block 0 of the tape prevents it from being image 
restored to a disc. 

-1 [ number ] 

Autochanger mode: This option is intended solely for autochanger type tape units (such as 
the HP 35401). During input or output operations (—i or —o) the autochanger option 
automatically selects the target cartridge from the magazine and begins the transfer. When 
utility function are used instead, (-u option) tcio loads the specified cartridge into the drive, 
but performs no read/write operations. (Note: the autochanger must be in selective mode for 
the autochanger option to work properly.) 

-n [ limit ] 

Applies only to autochanger units, and must be preceded by the -1 option. This option 
specifies the maximum number of cartridges to be used in a multi-tape transfer. Thus, -1 
starts the transfer by loading cartridge number and uses at most limit cartridges. If -1 is 
specified without —n, tcio quietly assumes the remaining cartridges (in ascending order) from 
the magazine. 

HARDWARE DEPENDENCIES 

Due to I/O software architecture, a buffersize greater than 64 provides no increase in performance, 
but merely ties up system memory. Thus, the default buffersize is 64. If buffersize is specified 
greater than 64, it is silently truncated back to 64. 

BACKGROUND INFORMATION 

Tcio enables immediate report on cartridge tape units that support this mode (such as the HP 
9144A, HP 7942/6, and HP 35401). Thus, the drive is able to return status before it completes 
writing data to the tape, allowing the host to send (or receive) data to the drive’s buffer while the 
drive is simultaneously transferring data from the drive to the tape. If the host is able to transfer 
data to (or from) the tape unit fast enough (so the drive does not need to reposition the tape 
between requests) the tape is said to stream. Streaming dramatically increases tape drive 
read/write data rates. 

Two basic strategies are available to the user. If the -S option is not specified, tcio uses as large a 
buffer as possible. The tape streams within the large transaction, but must reposition itself 
between successive requests (this strategy is recommended for the HP 7942/6 when transferring 
data between disk and tape). An alternate strategy is to use small buffers which can allow con¬ 
tinuous streaming. Continuous streaming is more efficient, provided the drive’s timing require¬ 
ments are met. Use of small buffers minimizes the time necessary for the host to refill the drive’s 
buffer. When reading or writing more than 8 Kbytes to a pipe, a small additional overhead is 
incurred. Thus, when tcio is used as part of a pipeline, a buffersize of 8 is recommended. This 
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alternate strategy for continuous streaming is sensitive to competing HP-IB activity. 

EXAMPLES 

The first example below copies the contents of a directory into an archive; the second restores it; 

Is I cpio -o I tcio -o /dev/rct 
tcio -i /dev/rct I cpio -i 

To unload the cartridge from the drive without verifying the tape, execute: 
tcio -urvV /dev/rct 

This example copies all files in the current directory (by executing find) to the tape specified by 
the device file /dev/rct. A checksum (option -d) is performed to verify that the data was written 
correctly on the tape, and verbose mode (-v) is used so you can see the names of all files being 
copied. In addition, a buffer size (option -S) of 8 blocks (i.e. 8 Kbytes) is specified: 

find . -print I cpio -o I tcio -odv -S 8 /dev/rct 

The next example assumes that the cartridge tape unit is an autochanger, with 8 slots in the 
magazine. The device has a read after write head, so verify is disabled. The tcio operation will 
start writing with cartridge 3, and will use at most 4 cartridges before prompting for additional 
media: 

find usr -print I cpio -o I tcio -oVv -1 3 -n 4 /dev/rhp35401 

The following example copies all the files and directories from the tape (specified by /dev/rct) to 
the current directory. Data is transferred through an 8-block buffer. 

tcio -ivr -S 8 /dev/rct I cpio -icdv 

The r flag in this example releases the tape after upon completion of the transfer. 

SEE ALSO 

cpio(l). 

BUGS 

If the cartridge drive cannot read the manufacturer’s block on the tape, the cartridge is locked in 
the drive and it cannot be extracted without removing power from the disc/tape drive. This 
failure is usually caused by faulty tape or a dirty drive mechanism. 


Hewlett-Packard 


- 3- 


November 19, 1985 



TCIO(l) 


Series 500 Implementation 


TCIO(l) 


NAME 

tcio - Command Set 80 Cartridge Tape Utility 

SYNOPSIS 

/etc/tcio -o [ dervSVC ] [ buffersize ] filename 
/etc/tcio -i [ drvS ] [ buffersize ] filename 

/etc/tcio -u [ cmrvV ] [ blocknumber ] [ save I restore ] filename [ disc_filename ] 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: This manual page describes the Series 500 implementation only. See other manual 
page for Series 200/300 implementation. Not supported on the Integral Personal Com¬ 
puter. 

DESCRIPTION 

Tcio -0 (copy out) reads the standard input and writes the data to the raw Command Set 80 
Cartridge Tape Unit specified by filename. 

Tcio -i (copy in) reads the Command Set 80 Cartridge Tape Unit specified by filename in raw 
mode and writes the data to the standard output. 

Tcio -u (utility) performs utility functions on the cartridge tape, such as image backup and 
restore, release, mark, and/or verify cartridge. 

In all cases, filename MUST refer to a character special file associated with a Command Set 80 
cartridge tape unit. 

With the output and input operations, tcio utilizes a large buffer to transfer data to/from the car¬ 
tridge tape, yielding a significant increase in performance, as well as a savings in wear and tear on 
the media and the mechanism. In addition, tcio puts a tape mark in the first block on each tape 
to prevent the tape from being image restored over a disc; it also utilizes the last block on each 
tape to fiag whether the tape is the last tape in a multi-tape sequence or not. 

With the utility operation, tcio provides functions that are unique to cartridge tapes. 

One of the options o, i, or u must be specified. The meanings of the available modifiers are: 

V Verbose mode; prints information and error messages to stderr. 

d Prints a checksum to stderr. The checksum is a 32-bit unsigned addition of the bytes, pro¬ 
viding an extra check of the validity of the tape in addition to tape verification. The value is 
only reported to the user and is not written on the media; thus, it’s left up to the user to 
manually record and check it. The checksum is valid only for the i and o operations, and if 
the same number of bytes are read from the tape as were written to it. This option is 
independent of the verbose modifier. 

e Applies only to the output operation, and causes a tape mark to be written on the nearest 
1024-byte boundary following the end of the data. When a tape containing an end-of-data 
tape mark is read back, the read will terminate upon encountering the tape mark. Thus, 
with the use of this option, the checksums generated by the input and output operations are 
guaranteed to agree. 

S Enables specification of buffer size. This option forces the allocation of a block of memory to 
be used in reading or writing the tape. The size in bytes of the buffer is 1024 times the value 
specified for buffersize. A buffersize less than 32 or greater than 512 will cause the program 
to terminate. If buffersize is not specified, tcio will attempt to allocate buffer sizes in powers 
of 2 from 512 down to 64, taking the largest one possible. The primary uses of this option 
are to allow buffer sizes smaller than 64 Kbytes, and to allow the user to pick a buffer size 
that is most suitable for his application. 
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This option turns off tape verification. It is suggested that this option not be used, for the 
sake of the integrity of the data output to tape. 

This option writes a tape mark on a tape at the specified block. If a tape is created by some 
other means than tcio^ a tape mark in block 0 of the tape will prevent it from being image 
restored to a disc. Note that blocknumber must be specified. 

Releases the tape from the mechanism, unlocking the door. 

Image copy option. Provides the same capability as the push-button save and restore avail¬ 
able in the HP 79XX single controller drive. The save and restore keywords are the same 
as the labels on those switches. Save implies disc to tape; restore implies tape to disc. 
Currently only single controller disc/tape units can be backed up in this way. 

Check read option. Provides a measure of data security not found in the tape verification or 
check digit options. Check read requires two I/O buffers of the size indicated by buffersize, 
one for writing and one for reading. The data in the first buffer is written to the tape. Then 
the tape is backspaced and read into the second buffer. The two buffers are then compared. 
If a difference occurs, tcio reports the error and terminates. This option forces no tape 
verification. Note that this option promotes wear and tear on both the media and the drive, 
and should only be used when complete assurance of the data’s integrity is required. 

HARDWARE DEPENDENCIES 

In general, tapes which have any tape marks other than in the first or the last block cannot be 
read successfully. 

The e option is not supported, and because of the above restriction, tapes which have been writ¬ 
ten under the e option cannot be read successfully. 

EXAMPLES 

The first example below copies the contents of a directory into an archive; the second restores it: 

Is I cpio -o I tcio “O /dev/rct 
tcio -i /dev/rct I cpio -i 

The next example copies all files in the current directory (via executing find) to the tape specified 
by the device file /dev/rct; a checksum (option -d) is performed to verify that the write to tape 
was performed correctly; verbose mode (-v) is used so that you can see the file names of files being 
copied; in addition, a buffer size (option -S) is specified at 128 memory blocks: 

find . -print I cpio -o I tcio -odvS 128 /dev/rct 

The following example copies all the files and directories from the tape (specified by /dev/rct) to 
the current directory; the data is transfered through a 128-block buffer. Note that with the cpio 
command, the wildcard character * is inclosed in double quotes this must be done so that the 
shell doesn’t expand the ♦ to all the files in the current directory—i.e., you want the ♦ to be inter¬ 
preted as all the files on the tape, not your current directory. Here is the command: 

tcio -ivS 128 /dev/rct I cpio -icdvu 

SEE ALSO 

cpio(l). 

WARNING 

To be able to use the save/restore facility, the following two conditions must be met: 
your system must be in single-user mode; 

you must never have used networking on your system. If networking has been used on 
your system, you must reboot the system before using the save/restore facility. 

Tcio can tie up substantial portions of memory, creating a situation where progress on other 
processes (including those processes feeding tcio) is hindered. If this should occur, it is best to kill 
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tcio and re-execute using a smaller buffersize. This problem is especially acute when using the C 
option, because two buffers are required. 

BUGS 

If the cartridge drive cannot read the manufacturer’s block on the tape, the cartridge is locked in 
the drive and cannot be extracted without turning off the disc/tape drive. This failure is usually 
the result of faulty tapes or a dirty drive mechanism. 
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NAME 

tee - pipe fitting 

SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

Native Language Support: 

8-bit data. 

DESCRIPTION 

Tee transcribes the standard input to the standard output and makes copies in the files. The -i 
option ignores interrupts; the -a option causes the output to be appended to the files rather than 
overwriting them. 
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NAME 

test, [ - condition evaluation command 

SYNOPSIS 

test expr 
[ expr ] 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System III 

DESCRIPTION 

Test evaluates the expression expr and, if its value is true, returns a zero (true) exit status; other¬ 
wise, a non-zero (false) exit status is returned; test also returns a non-zero exit status if there are 
no arguments. The following primitives are used to construct expr: 

-r file true if file exists and is readable. 

-w file true if file exists and is writable. 

-X file true if file exists and is executable. 

-f file true if file exists and is a regular file. 

-d file true if file exists and is a directory. 

-c file true if file exists and is a character special file. 

-b file true if file exists and is a block special file. 

-p file true if file exists and is a named pipe (fifo). 

-u file true if file exists and its set-user-ID bit is set. 

-g file true if file exists and its set-group-ID bit is set. 

-k file true if file exists and its sticky bit is set. 

-s file true if file exists and has a size greater than zero. 

-t [ fildes ] true if the open file whose file descriptor number is fildes (1 by default) is associated 
with a terminal device. 

-z si true if the length of string si is zero. 

-n si true if the length of the string si is non-zero. 

si = s2 true if strings si and s2 are identical. 

si 1= s2 true if strings si and s2 are not identical. 

si true if si is not the null string. 

nl -eq n2 true if the integers nl and n2 are algebraically equal. Any of the comparisons -ne, 
-gt, -ge, -It, and -le may be used in place of -eq. 

These primaries may be combined with the following operators: 

! unary negation operator. 

-a binary and operator. 

-o binary or operator (-a has higher precedence than -o). 

( expr ) parentheses for grouping. 

Notice that all the operators and flags are separate arguments to test. Notice also that 
parentheses are meaningful to the shell and, therefore, must be escaped. 
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Test is directly interpreted by the shell. 

SEE ALSO 

eval(l) (see sh{l)), find(l), sh(l). 

WARNING 

In the second form of the command (i.e., the one that uses [], rather than the word test), the 
square brackets must be delimited by blanks. 

The second form of the command ([ ]) is not recognized by csh. 
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NAME 

time - time a command 

SYNOPSIS 

time command 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

The command is executed; after it is complete, time prints the elapsed time during the command, 
the time spent in the system, and the time spent in execution of the command. Times are 
reported in seconds. 

The execution time can depend on the performance of the memory in which the program is run¬ 
ning. 

The times are printed on standard error. 

HARDWARE DEPENDENCIES 

Series 500: 

For those computers with multiple CPU’s, the child CPU times listed may be greater than 
the actual real elapsed time, since CPU time is counted on a per-CPU basis. Thus, if three 
CPUs are executing, the times listed are obtained by adding the execution times of each 
CPU. 

SEE ALSO 

times command in sh(l), timex(l), times(2). 
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NAME 

touch - update access, modification, and/or change times of file 

SYNOPSIS 

touch [ -amc ] [ mmddhhmm[yy] ] files 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Touch causes the access, modification, and last change times of each argument to be updated. 
The file name is created if it does not exist. If no time is specified (see date{l)) the current time 
is used. The -a and -m options cause touch to update only the access or modification times 
respectively (default is -am). The -c option silently prevents touch from creating the file if it did 
not previously exist. 

The return code from touch is the number of files for which the times could not be successfully 
modified (including files that did not exist and were not created). 

SEE ALSO 

date(l), utime(2). 
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NAME 

tput - query terminfo database 

SYNOPSIS 

tput [ -Ttype ] capname 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Tput uses the terminfo (5) database to make terminal-dependent capabilities and information 
available to the shell. Tput outputs a string if the attribute (capability name) is of type string, 
or an integer if the attribute is of type integer. If the attribute is of type boolean, tput simply 
sets the exit code (0 for TRUE, 1 for FALSE), and does no output. 

-Ttype indicates the type of terminal. Normally this flag is unnecessary, as the default is 
taken from the environment variable $TERM. 

Capname indicates the attribute from the terminfo database. See terminfo (5). 

EXAMPLES 

tput clear Echo dear-screen sequence for the current terminal, 

tput cols Print the number of columns for the current terminal. 

tput -Thp2623 cols 

Print the number of columns for the hp2623 terminal. 
bold=‘tput smso‘ Set shell variable "bold" to stand-out mode sequence for current terminal. 
This might be followed by a prompt: 
echo "${bold}Please type in your name: \c" 
tput he Set exit code to indicate if current terminal is a hardcopy terminal. 

FILES 

/usr/lib/terminfo/?/* Terminal descriptor files 

/usr/include/term.h Definition files 

/usr/ include/curses. h 

DIAGNOSTICS 

Tput prints error messages and returns the following error codes on error: 

—1 Usage error. 

-2 Bad terminal type. 

-3 Bad capname. 

In addition, if a capname is requested for a terminal that has no value for that capname (e.g., 
tput -T450 lines), -1 is printed. 

SEE ALSO 

stty(l), terminfo(5). 
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NAME 

tr - translate characters 
SYNOPSIS 

tr [ -cds ] [ stringl [ string2 ] ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Tr copies the standard input to the standard output with substitution or deletion of selected 
characters. Input characters found in stringl are mapped into the corresponding characters of 
string2. Any combination of the options -cds may be used: 

-c Complements the set of characters in stringl with respect to the universe of characters 

whose ASCII codes are 001 through 377 octal. 

-d Deletes all input characters in stringl. 

-s Squeezes all strings of repeated output characters that are in string2 to single characters. 

The following abbreviation conventions may be used to introduce ranges of characters or repeated 
characters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run from character a to character 
z, inclusive. 

[a*n] Stands for n repetitions of a. If the first digit of n is 0, n is considered octal; otherwise, 
n is taken to be decimal. A zero or missing n is taken to be huge; this facility is useful 
for padding string2. 

The escape character \ may be used as in the shell to remove special meaning from any character 
in a string. In addition, \ followed by 1, 2, or 3 octal digits stands for the character whose ASCII 
code is given by those digits. 

EXAMPLE 

The following creates a list of all the words in filel one per line in file2, where a word is taken to 
be a maximal string of alphabetics. The strings are quoted to protect the special characters from 
interpretation by the shell; 012 is the ASCII code for newline. 

tr -cs "[A-Z][a-z]" "[\012*]" <filel >file2 

SEE ALSO 

ed(l), sh(l), ascii(7). 

BUGS 

Will not handle ASCII NUL in stringl or string2] always deletes NUL from input. 
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NAME 

true, false - provide truth values 

SYNOPSIS 

true 

false 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

True does nothing, successfully. False does nothing, unsuccessfully. They are typically used in 
input to sh{l) such as: 

while true 
do 

command 

done 

SEE ALSO 

machid(l), sh(l). 

DIAGNOSTICS 

True has exit status zero, false nonzero. 
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NAME 

tset - terminal dependent initialization 

SYNOPSIS 

tset [ options ] [ -m [ ident ] [ test baudrate ] :type ] ... [ type ] 

reset ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

Tset sets up your terminal when you first log in to an HP-UX system. It does terminal-dependent 
processing such as setting erase and kill characters, setting or resetting delays, and sending any 
sequences needed to properly initialize the terminal. It first determines the type of terminal 
involved, then performs the necessary initializations and mode settings. The type of terminal 
attached to each HP-UX port is specified in the /etc/ttytype data base. Type names for terminals 
are stored in the /usr/lib/terminfo/?/* data base. If a port is not hardwired directly to a specific 
terminal (thus considered a modem connection), it is given an appropriate generic identifier, such 
as dialup. 

In the case where no arguments are specified, tset simply reads the terminal type out of the 
environment variable TERM and re-initializes the terminal. The rest of this manual entry con¬ 
cerns itself with mode and environment initialization, typically done once at login, and options 
used at initialization time to determine the terminal type and set up terminal modes. 

When used in a startup script {.profile for sh{l) users, or .login for csh{l) users) it is desirable to 
give information about the type of terminal you will usually use on ports, which are not hardwired. 
These ports are identified in /etc/ttytype as dialup or plugboard^ etc. To specify what terminal 
type you usually use on these ports, the —m (map) option flag is followed by the appropriate port 
type identifier, an optional baud rate specification, and the terminal type. (The effect is to "map" 
from some conditions to a terminal type, that is, to tell tset, "If Pm on this kind of port, then Pll 
probably be on this kind of terminal".) If more than one mapping is specified, the first applicable 
mapping prevails. A missing port type identifier matches all identifiers. A baudrate is specified as 
with stty(l), and is compared with the speed of the diagnostic output (which should be the control 
terminal). The baud rate test may be any combination of >, =, <, and !; @ is a synonym for 
= and ! inverts the sense of the test. To avoid problems with metacharacters, it is best to place 
the entire argument to -m within single quotes; users of csh{l) must also put a "\" before any "!" 
used. 

Thus, 

tset -m 'dialup>300:2622' -m 'dialup:2624' -m 'plugboard:?2623' 

causes the terminal type to be set to an HP 2622 if the port in use is a dialup at a speed greater 
than 300 baud, or to an HP 2624 if the port is otherwise a dialup (i.e. at 300 baud or less). If the 
type finally determined by tset begins with a question mark, the user is asked if he or she really 
wants that type. A null response means to use that type; otherwise, another type can be entered. 
Thus, in the above case, if the user is on a plugboard port, he or she will be asked whether or not 
he or she is actually using an HP 2623. 

If no mapping applies and a final type option, not preceded by a -m, is given on the command 
line, then that type is used. Otherwise, the identifier found in the /etc/ttytype data base will be 
taken to be the terminal type. The latter should always be the case for hardwired ports. 

It is usually desirable to return the terminal type, as finally determined by tset, and information 
about the terminal’s capabilities to a shell’s environment. This can be done using the -s option. 
Using the Bourne shell (5/i(l)), the command 

eval 'tset -s options...' 
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or using the C shell, csh{l): 

set noglob; eval 'tset -s options...' 

These commands cause tset to generate as output a sequence of shell commands which place the 
variable TERM in the environment; see enmVon(5). 

Once the terminal type is known, tset engages in terminal mode setting. This normally involves 
sending an initialization sequence to the terminal, setting the single character erase (and option¬ 
ally the full line erase or line-kill) characters, and setting special character delays. Tab and new- 
line expansion are turned off during transmission of the terminal initialization sequence. 

On terminals that can backspace but not overstrike (such as a CRT), and when the erase charac¬ 
ter is the default erase character ("#" on standard systems), the erase character is changed to 
BACKSPACE (^H). 

The options are: 

—ec sets the erase character to be the named character c; c defaults to ''H (BACKSPACE). 

The character c can either be typed directly, or entered using the "hat" notation used 
here (e.g. the "hat" notation for control-H is "H; in sh{l), the " character should be 
escaped (\")). 

—kc sets the kill character to c. The default c is "X. If c is not specified, the kill character 

will remain unchanged unless the original value of the kill character is null. In this case, 
the kill character is set to an "at" sign (@). 

- report terminal type. Whatever type is decided on is reported. If no other flags are 
given, the only effect is to write the terminal type on the standard output. 

-s generates appropriate commands (depending on your SHELL environment variable) to set 
TERM. 

—I suppresses transmitting terminal initialization strings. 

-Q suppresses printing the "Erase set to" and "Kill set to" messages. 

-A asks the user for the TERM type. 

-S Outputs the string that would be assigned to TERM in the environment rather than gen¬ 
erating commands for a shell. In sh{l), the following is an alternate way of setting 
TERM. 

set — 'tset -S ...' 

TERM=$1 

For compatibility with earlier versions of tset, the following flags are accepted, but their use is 
discouraged: 

-r report to the user in addition to other flags. 

-Ec sets the erase character to c only if the terminal can backspace. (7 defaults to "H. 

EXAMPLES 

These examples all assume the Bourne shell {sh{l)). Note that a typical use of tset in a .profile 
will also use the -e and -k options, and often the -n or -Q options as well. These options have 
not been included here to keep the examples small. 

Assume, for the moment, that you are on an HP 2622. This is suitable for typing by hand but 
not for a .profile, unless you are always on a 2622. 

export TERM; TERM='tset - 2622' 

Now, you have an HP 2623 at home which you dial up on, but your office terminal is hardwired 
and known in /etc/ttytype. 
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export TERM; TERM='tset-m dialup:2623' 

You have a switch which connects everything to everything, making it nearly impossible to key on 
what port you are coming in on. You use an HP 2622 in your office at 9600 baud, and dial up to 
switch ports at 1200 baud from home on an HP 2623. Sometimes you use someone else’s terminal 
at work, so you want it to ask you to make sure what terminal type you have at high speeds, but 
at 1200 baud you are always on a 2623. Note the placement of the question mark, and the quotes 
to protect the > and ? from interpretation by the shell. 

export TERM; TERM—'tset-m 'switch>1200:?2622' -m 'switch<=1200:2623'' 

All of the above entries will fall back on the terminal type specified in /etc/ttytype if none of the 
conditions hold. The following entry is appropriate if you always dial up, always at the same 
baud rate, on many diflFerent kinds of terminals. Your most common terminal is an HP 2622. It 
always asks you what kind of terminal you are on, defaulting to 2622. 

export TERM; TERM='tset - ?2622' 

If the file /etc/ttytype is not properly installed and you want to key entirely on the baud rate, the 
following can be used: 

export TERM; TERM='tset-m '>1200:2624' 2622' 

FILES 

/etc/ttytype port name to terminal type mapping data base; 

/usr/lib/terminfo/?/* terminal information data base. 

VARIABLES 

SHELL if "csh" then generate csh{l) commands, otherwise generate sh{l) commands. 

TERM the (canonical) terminal name. 

SEE ALSO 

csh(l), sh(l), stty(l), ttytype(5), terminfo(5), environ(7). 
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NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items consistent with a partial 
ordering of items mentioned in the input file. If no file is specified, the standard input is under¬ 
stood. 

The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different 
items indicate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 

lorder(l). 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input file. 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 
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NAME 

tty - get the name of the terminal 

SYNOPSIS 

tty [ -s ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Tty prints the path name of the user’s terminal. The -s option inhibits printing of the terminal 
path name, allowing one to test just the exit code. 

RETURN VALUE 

0 if standard input is a terminal, 

1 otherwise. 

2 if invalid options were specified, 

DIAGNOSTICS 

“not a tty” if the standard input is not a terminal and -s is not specified. 
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NAME 

ul - do underlining 
SYNOPSIS 

ul [ -i ] [ -t terminal ] [ name ... ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

DESCRIPTION 

Ul reads the named files (or standard input if none are given) and translates occurences of under¬ 
scores to the sequence which indicates underlining for the terminal in use, as specified by the 
environment variable TERM. The -t option overrides the terminal kind specified in the environ¬ 
ment. The termmfo{b) file corresponding to TERM is read to determine the appropriate 
sequences for underlining. If the terminal is incapable of underlining, but is capable of a standout, 
mode then that is used instead. If the terminal can overstrike, or handles underlining automati¬ 
cally, ul degenerates to cat(l). If the terminal cannot underline, underlining is ignored. 

The -i option causes ul to indicate underlining on a separate line containing appropriate dashes 
this is useful when you want to look at the underlining which is present in an nroff output stream 
on a CRT. 

FILES 

/usr/lib/terminfo/?/* terminal capability files 

SEE ALSO 

man(l), nroff(l). 

BUGS 

Nroff usually outputs a series of backspaces and underlines intermixed with the text to indicate 
underlining. No attempt is made to optimize the backward motion. 
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NAME 

umask - set file-creation mode mask 

SYNOPSIS 

umask [ ooo ] 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System III 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

The user file-creation mode mask is set to ooo. The three octal digits refer to read/write/execute 
permissions for owner, group, and others, respectively (see chmod{2) and umask[2)). The value 
of each specified digit is subtracted from the corresponding “digit” specified by the system for the 
creation of a file (see creat{2)). For example, umask 022 causes files to be created without write 
permission for group or other, (files normally created with mode 777 become mode 755; files 
created with mode 666 become mode 644). Existing files are not affected. 

If ooo is omitted, the current value of the mask is printed with four octal digits. The first digit, a 
zero, specifies that the output is expressed in octal. 

Umask is recognized and executed by the shell. 

Note that the file creation mask does not affect the set-user-ID, set-group-ID, or "sticky" bits. 

SEE ALSO 

chmod(l), sh(l), chmod(2), creat(2), umask(2). 


Hewlett-P ackard 


- 1 - 


July 2, 1985 



UNAME(l) 


UNAME(l) 


NAME 

uname - print name of current HP-UX version 

SYNOPSIS 

uname [ -snrvmia ] 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System V 

DESCRIPTION 

Uname prints the current system name of the HP-UX system on the standard output file. It is 

mainly useful to determine which system one is using. The options cause selected information 

returned by uname[2) to be printed: 

-s print the system name (default). 

-n print the nodename (the nodename may be a name that the system is known by on a 
communications network), (e.g. uucp). 

-r print the operating system release. 

-V print the operating system version. 

-m print the machine hardware name. 

-i print the machine identification number. 

-a print all the above information. 

SEE ALSO 

hostname(l), gethostname(2), sethostname(2), uname(2). 

BUGS 

The -i option reports the nodename if and only if the machine has no promid. 
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NAME 

unget - undo a previous get of an SCCS file 
SYNOPSIS 

unget [-rSID] [-s] [-n] files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Unget undoes the effect of a get -e done prior to creating the intended new delta. If a directory is 
named, unget behaves as though each file in the directory were specified as a named file, except 
that non-SCCS files and unreadable files are silently ignored. If a name of - is given, the standard 
input is read with each line being taken as the name of an SCCS file to be processed. Refer to 
sact{l), which describes how to determine what deltas are currently binding for an s-file. 

Key letter arguments apply independently to each named file. 

-rSID Uniquely identifies which delta is no longer intended. (This would have been 

specified by get as the “new delta”). The use of this keyletter is necessary 
only if two or more outstanding gets for editing on the same SCCS file were 
done by the same person (login name). A diagnostic results if the specified 
SID is ambiguous, or if it is necessary and omitted on the command line (see 
sact{l)). 

-s Suppresses the printout, on the standard output, of the intended delta’s SID. 

-n Causes the retention of the gotten file which would normally be removed from 

the current directory. 

Note: unget can only be executed by the user who did the corresponding get -e. If a sys¬ 
tem administrator needs to unget a get -e done by another user, he must either use su{l) to 
change into that user, or edit the p-file directly (which can be done either by the s-file 
owner of the super-user). 

FILES 

p-file see delta(l). 

g-file see delta{l). 

SEE ALSO 

delta(l), get(l), help(l), sact(l). 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

uniq - report repeated lines in a file 
SYNOPSIS 

uniq [ -udc [ -|-n ] [ -n ] ] [ input [ output ] ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages. 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the normal case, the second and succeeding 
copies of repeated lines are removed; the remainder is written on the output file. Input and out¬ 
put should always be different. Note that repeated lines must be adjacent in order to be found; 
see sort{l). If the -u fiag is used, just the lines that are not repeated in the original file are out¬ 
put. The -d option specifies that one copy of just the repeated lines is to be written. The normal 
mode output is the union of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output report in default style but with each 
line preceded by a count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each line in the comparison: 

-n The first n fields together with any blanks before each are ignored. A field is defined as 
a string of non-space, non-tab characters separated by tabs and spaces from its neigh¬ 
bors. 

The first n characters are ignored. Fields are skipped before characters. 

SEE ALSO 

comm(l), sort(l). 
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NAME 

units - conversion program 

SYNOPSIS 

units 

HP-UX COMPATIBILITY 

Level; HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Units converts quantities expressed in various standard scales to their equivalents in other scales. 
It works interactively in this fashion: 

You have: inch 
You want; cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units optionally preceded by a numeric 
multiplier. Powers are indicated by suffixed positive integers, and division by the usual sign: 

You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+00 
/ 9.797299e-01 

Units only does multiplicative scale changes; thus it can convert Kelvin to Rankine, but not Cel¬ 
sius to Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, 
together with a generous leavening of exotica and a few constants of nature including: 


pi 

ratio of circumference to diameter 

c 

speed of light 

e 

charge on an electron 

g 

acceleration of gravity 

force 

same as g. 

mole 

Avogadro’s number, 

water 

pressure head per unit height of water. 

au 

astronomical unit. 


Pound is not recognized as a unit of mass; lb is. Compound names are run together, (e.g., ligh— 
tyear). British units that differ from their U.S. counterparts are prefixed thus: brgallon. For a 
complete list of units, type: 

cat /usr/lib/unittab 

FILES 

/usr/lib/unittab 

BUGS 

units{l) expects the singular form of each unit to be entered, but will attempt to form the singu¬ 
lar by deleting a trailing "s" if the singular form is not found. Thus, some plurals will be correctly 
recognized, while others will not. 
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NAME 

upm - unpack cpio archives from HP media 

SYNOPSIS 

upm -E [ cdmtuvx ] pathname chardevice [ patterns ] 
upm -iM [ cdmtuvx ] [ patterns ] </dev/rmf? 

HP-UX COMPATIBILITY 

Level: HP-UX/NON-STANDARD 

Origin: HP 

Remarks: Upm is implemented on the Series 500 only. 

DESCRIPTION 

Upm is similar to cpio(l), and is included to enable you to restore files from 88140L/S tape car¬ 
tridges or 5.25-inch flexible discs more efficiently. 

Upm -E (copy in from tape cartridge) extracts all files specified by patterns from the file named by 
pathname (assumed to be the product of a previous cpio -o). Patterns is a series of zero or more 
blank-separated character strings given in the name-generating notation of sh(l). Note that the 
metacharacters ?, *, and [...] match the slash (/) when used in patterns. The default pattern is 
which selects all files. Chardevice identifies the character special device file describing the 
volume containing pathname. (Note that, if this volume is not the root, it must be mounted at 
the time upm is used, and pathname must include the directory name on which the volume is 
mounted.) 

Upm -iM (copy in) extracts all files selected by zero or more of the specified patterns (see above 
for a description of patterns). The files are extracted from the standard input, which is redirected 
from a raw miniature flexible disc device /dev/rmf?. The resulting standard input is assumed to 
be the product of a previous cpio -o. 

Any other options specified must be concatenated with the initial E or iM options. The options 
have the following meanings: 

c read header information which was previously written in ASCII character form for portabil¬ 
ity; 

d directories are to be created as needed; 

m retain previous file modification time. This option is ineffective on directories that are being 
copied; 

t print a table of contents of the input; no files are created; 

u copy unconditionally (normally, an older file will not replace a newer file with the same 
name); 

v verbose; causes a list of file names to be printed. When used with the t option, the table of 
contents looks like the output of an Is -I command (see /s(l)); 

X restore device special files; mknod{2) is used to recreate these files, and thus -Ex or -iMx can 
only be used by the super-user. Restoring device files onto a different system can be very 
dangerous. This is intended for backup use; 

When the end of a volume is reached, upm will prompt the user for the next flexible disc and con¬ 
tinue. 

The number of blocks reported by upm is always in units of 512-byte blocks, regardless of the 
block size of the initialized media. 

SEE ALSO 

cpio(l), tcio(l), mknod(2). 

WARNING 

The -B option must not be used when performing raw I/O using the HP 9130K miniature flexible 
disc drive. 
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BUGS 

Only the super-user can copy special files. 

If /dev/tty is not accessible, upm issues a complaint, or refuses to work. 
The -Edr and -iMdr options will not make empty directories. 
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NAME 

UUCP, uulog, uuname - HP-UX system to HP-UX system copy 

SYNOPSIS 

UUCP [ options ] source-files destination-file 
uulog [ options ] 

uuname [ -1 ] [ -v ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Uucp. 

Uucp copies files named by the source-file arguments to the destination-file argument. A file 
name may be a path name on your machine, or may have the form: 

system-name !path-name 

where system-name is taken from a list of system names which uucp knows about. The system- 
name may also be a list of names such as 

system-name !system-name!... !system-name!path-name 

in which case an attempt is made to send the file via the specified route, and only to a destination 
in PUBDIR (see below). Care should be taken to insure that intermediate nodes in the route are 
willing to toward information. 

The shell metacharacters ?, * and [...] appearing in path-name will be expanded on the 
appropriate system. 

Path names may be one of: 


( 1 ) 

a full path name; 


( 2 ) 

a path name preceded by ~'user where user is a login name 
tern and is replaced by that user’s login directory; 

on the specified sys- 

( 3 ) 

a path name preceded by ~ juser where user is a login name on the specified sys¬ 
tem and is replaced by that user’s directory under PUBDIR (see FILES); 

( 4 ) 

anything else is prefixed by the current directory. 



The local and remote system access to the path name is specified in the USERFILE. If the result is 
an erroneous path name for the remote system the copy will fail. If the destination-file is a direc¬ 
tory, the last part of the source-file name is used. The accessibility of the file or path name is 
specified in USERFILE. 

Uucp preserves execute permissions across the transmission and gives 0666 read and write permis¬ 
sions (see chmod{2)). 

The following options are interpreted by uucp: 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

-c Use the source file when copying out rather than copying the file to the spool directory 
(default). 

-C Copy the source file to the spool directory immediately and use the copy. 

-mfile Report status of the transfer in file. If file is omitted, send mail to the requester when the 
copy is completed. 
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-nuser Notify user on the remote system that a file was sent. 

-^sys Send the uucp command to system sys to be executed there. (Note: this will only be suc¬ 
cessful if the remote machine allows the uucp command to be executed by 

/usr/lib/uucp/uuxqt.) 

-ggrade 

Request grade as a priority for the work sequencing. Grades are specified in the order A - 
Z, a - z, with A specifying that the work should be done first, and z specifying that the 
work should be done last. All other grades specify a sequence somewhere in between. 
The default is n. 

-r Queue job but do not start the file transfer process. By default a file transfer process is 
started each time uucp is evoked. 

-j Control writing of the uucp job number to standard output (see below). 

Uucp associates a job number with each request. This job number can be used by uustat to 
obtain status or terminate the job. 

The environment variable JOBNO and the -j option are used to control the listing of the uucp 
job number on standard output. If the environment variable JOBNO is undefined or set to 
OFF, the job number will not be listed (default). If uucp is then invoked with the -j option, the 
job number will be listed. If the environment variable JOBNO is set to ON and is exported, a 
job number will be written to standard output each time uucp is invoked. In this case, the -j 
option will supress output of the job number. 

Uulog 

Uulog queries a summary log of uucp and uux{lC) transactions in the file 

/usr/spool/uucp/LOGFILE. 

The options cause uulog to print logging information: 

-^sys Print information about work involving system sys. If sys is not specified, then logging 
information for all systems will be printed. 

-nuser Print information about work done for the specified user. If user is not specified then 
logging information for all users will be printed. 

Uuname. 

Uuname lists the uucp names of known systems. Duplicate lines are not shown, but blank lines 
are. The -1 option returns the local system name. The -v option will print additional information 
about each system. A description will be printed for each system that has a line of information in 
/usr/lib/uucp/ADMIN. The format of ADMIN is: 

sysname tab description tab. 

FILES 

/usr/spool/uucp spool directory 

/usr/spool/uucppublic public directory for receiving and sending (PUBDIR) 

/usr/lib/uucp/* other data and program files 

SEE ALSO 

mail(l), uux(lC), chmod(2). 

WARNING 

The domain of remotely accessible files can (and for obvious security reasons, usually should) be 
severely restricted. You will very likely not be able to fetch files by path name; ask a responsible 
person on the remote system to send them to you. For the same reasons, you will probably not 
be able to send files to arbitrary path names. As distributed, the remotely accessible files are 
those whose names begin /usr/spool/uucppublic (equivalent to ~uucp or just ~). Note that, if 
/etc/passwd contains a blank line, a null user entry, or an entry for ~uucp, then ~ and ~uucp will 
not expand properly. Because of this, the uuto script will not send files to the proper directory. 
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NOTES 

In order to send files that begin with a dot (e.g., .profile) the files must by qualified with a dot. 
For example: .profile, .prof*, .profil? are correct; whereas *prof*, ?profile are incorrect. 

Uucp will not generate a job number for a strictly local transaction. 

BUGS 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. Receiving multiple files 
specified by special shell characters ? ♦ [... ] will not activate the -m option. 

The -m option will not work if all transactions are local or if uucp is executed remotely via the -e 
option. 

The -n option will function only when the source and destination are not on the same machine. 
Any excess characters are ignored. 

If uulog is issued with no parameters when a uucp process is writing to a temporary logfile, some 
log information (that information written after the LOG.* files are unlinked) may be lost. 

Uucp, when used to copy files locally, will create the new file with mode 644 instead of 666. 
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NAME 

uuls - list spooled uucp transactions grouped by transaction 

SYNOPSIS 

uuls [-m] [directories..] 
uuls -s [-m] [directories..] 
uuls -k [-m] [directories..] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Remarks: Not supported on the Integral PC. 

DESCRIPTION 

This command lists the contents of uucp spool directories (default "/usr/spool/uucp") with the 
files grouped into three categories: 

Transactions: 

Each line starts with a transaction control filename and includes the name of each local (same- 
directory) subfile referenced by the control file (see below). Each is possibly followed by the total 
size in bytes (-s option) or Kbytes (-k option) in the transaction (see below). The -m (meanings) 
option replaces the subfile names with nodename, user, and commandline information (see below). 

Orphans: 

All subfiles not referenced by any control file. 

Others: 

All other files in the directory (all files not listed under one of the above categories). 

Filenames are columnated so there may be more than one file per line. If a transaction has more 
subfiles than fit on one line, it is followed by continuation lines which are indented further. 

The -s (size in bytes) and -k (Kbytes) options cause the command to follow each transaction in 
the Transactions section with a total size for all stat-able, sendable files in that transaction. This 
includes "D.*" files only, not "C.*" or "X.*" files. It does include stat-able files outside the spool 
directory which are indirectly referenced by "C.*" files. Sizes are either in bytes or rounded to the 
nearest Kbyte (1024 bytes), respectively. A totals line is also added at the end of the Transac¬ 
tions section. 

The -m (meanings) option causes the command to follow "C.*" and "X.*" files with a 
" nodenamelusername commandline" line, instead of subfilenames. For "C" files, one line is 
printed per remote execution ("D+X*") subfile it references. Nodename is truncated at seven 
characters, username at eight, and commandline at however much fits on one line. 

If -m is given, for each "C" file with no remote execution files, the command instead shows the 
meaning of the "C" file itself on one or more lines. Each line consists of a username, then "R" 
(receive) or "S" (send), then the name of the file to be transferred. See below for details. 

Filenames are listed in alphabetical order within each section, except that the first section is only 
sorted by the control filename. Every file in the directory except and appears exactly 
once in the entire list, unless -m is used. 

Details 

Transaction files are those whose names start with "C." or "X.". Subfilenames, which usually 
start with "D.", are gleaned from control file lines, at most one per line, from blank-separated 
fields, as follows: 

C.*: R <remotefrom> <localto> <user> -<options> 

C.*: S <localfrom> <remoteto> <user> -<options> <subfile> <mode> 

X.*: F <subfile> 
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Lines that don’t begin with the appropriate character (’R’, ’S’, or ’F’) are ignored. 

In the "R" (receive) case, <remotefrom> is used to print the "C"-file meaning, and its transac¬ 
tion size is taken as zero (unknown). 

In the "S" (send) case, if <subfile> is "D.O", <localfrom> is a file not in the spool directory, 
resulting from a typical uucp call without the -C (copy) option. In this case <localfrom> is used 
for the transaction size, if stat-able, and to print the "C"-file meaning. 

UUCP -C and uux both set <subfile> to a true (spooled) subfile name. 

Orphan files are those whose names start with "D." and which are not referenced by any control 
files. 

This algorithm extracts from control files the names of all subfiles which should exist in the spool 
directory when the transaction is not being actively processed. It is not unusual to see "missing 
subfiles" and "orphans" if you uuls a spool directory while uucico, uucp, uux, or uuxqt is 
active. 

Meanings information is gotten by reading each "D*X*" subfile referenced by each "C.*" file, and 
by reading "X*X*" files. Nodenamelusername is taken from the last line in the file which is of the 
form: 


U <username> <nodename> 

Likewise, commandline is taken from the last line of the form: 

C <commandline> 

If a subfile name is referenced more than once, references after the first show the subfile as miss¬ 
ing. If a subfile name appears in a (corrupt) directory more than once, the name is only found 
once, but then it is listed again under Orphans. 

HARDWARE DEPENDENCIES 

Uuls uses directory{3x), but it truncates filenames to 14 characters. This should cause no prob¬ 
lems, even if longer names are allowed, due to the uucp file naming conventions. 

SEE ALSO 

mail(l), uucp(l), uuto(l), uux(l), uuxqt(l), stat(2). 

DIAGNOSTICS 

The program writes an appropriate message to standard error if it has any problems dealing with 
a specified file (directory), including failure to get heap space. It always returns zero as its exit 
value. 

If a control file is unopenable (wrong permissions or it disappeared while uuls was running), its 
name is preceded by a "*" and the size of the transaction is zero. If a subfile is missing (filename 
not found in the directory being listed) or un-stat-able (if required for -s or -k), its name is pre¬ 
ceded by a "*" and it contributes zero bytes to the size of the transaction. 

If -m is specified and a "D=f'X*" file is missing or unreadable, its name is given with a "*" 
prepended, as usual. 

BUGS 

This command uses chdir(2) to change to each directory in turn. If more than one is specified, 
the second through last directories must be absolute (not relative) pathnames, or the chdir() may 
fail. (This could be fixed, but might result in the program running slower.) 
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NAME 

uusnap - show snapshot of the UUCP system 

SYNOPSIS 

uusnap 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

DESCRIPTION 

Uusnap displays in tabular format a synopsis of the current UUCP situation. The format of each 
line is as follows: 

site N Cmds N Data N Xqts Message 

Where "site" is the name of the site with work, "N" is a count of each of the three possible types 
of work (command, data, or remote execute), and "Message" is the current status message for 
that site as found in the STST file. 

Included in "Message" may be the time left before UUCP can re-try the call, and the count of the 
number of times that UUCP has tried to reach the site. The process ID of a UUCICO or other 
demon may also be shown if it is in a "Talking of LOCKED" state. 

SEE ALSO 

uucp(lC), Serial Network Communications Guide. 
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NAME 

uustat - UUCP status inquiry and job control 

SYNOPSIS 

uustat [ options ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Uustat will display the status of, or cancel, previously specified uucp commands, or provide gen¬ 
eral status on uucp connections to other systems. At most one of the following options may be 
specified: 

-jjobn Report the status of the uucp request jobn. If all is used for jobn, the status of all 
uucp requests is reported. An argument must be supplied otherwise the usage message 
will be printed and the request will fail. 

-kjobn Kill the uucp request whose job number is jobn. The killed uucp request must belong 
to the person issuing the uustat command unless one is the super-user. 

-vjobn Rejuvenate jobn. That is, jobn is touched so that its modification time is set to the 
current time. This prevents unclean from deleting the job until the jobs modification 
time reaches the limit imposed by unclean. 

-chour Remove the status entries which are older than hour hours. This administrative 
option can only be initiated by the user uucp or the super-user. 

-mmch Report the status of accessibility of machine mch. If mch is specified as all, then the 
status of all machines known to the local uucp are provided. 

-Mmc/i This is the same as the -m option except that two times are printed. The time that 
the last status was obtained and the time that the last successful transfer to that sys¬ 
tem occurred. 

If none of the above options are specified, any or all of the following options may appear: 

-\iuser Report the status of all uucp requests issued by user. 

-ssys Report the status of all uucp requests which communicate with remote system sys. 

-ohour Report the status of all uucp requests which are older than hour hours. 

-yhour Report the status of all uucp requests which are younger than hour hours. 

-O Report the uucp status using the octal status codes listed below. If this option is not 

specified, the verbose description is printed with each uucp request. 

-q List the number of jobs and other control files queued for each machine and the time 

of the oldest and youngest file queued for each machine. If a lock file exists for that 
system, its date of creation is listed. 

When no options are given, uustat outputs the status of all uucp requests issued by the current 
user. 

For example, the command: 

uustat -uhdc -smhtsa -y72 

will print the status of all uucp requests that were issued by user hdc to communicate with sys¬ 
tem mhtsa within the last 72 hours. The meanings of the job request status are: 

job-number user remote-system command-time status-time status 

where the status may be either an octal number or a verbose description. The octal code 
corresponds to the following description: 
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OCTAL STATUS 

000001 the copy failed, but the reason cannot be determined 

000002 permission to access local file is denied 

000004 permission to access remote file is denied 

000010 bad uucp command is generated 

000020 remote system cannot create temporary file 

000040 cannot copy to remote directory 

000100 cannot copy to local directory 

000200 local system cannot create temporary file 

000400 cannot execute uucp 

001000 copy (partially) succeeded 

002000 copy finished, job deleted 

004000 job is queued 

010000 job killed (incomplete) 

020000 job killed (complete) 

The meanings of the machine accessibility status are: 
system-name time status 

where time is the latest status time and status is a self-explanatory description of the machine 

status. 


FILES 

/ usr / spool / uucp 

/ usr/lib/uucp/L_stat 

/ usr/lib / uucp/R_stat 


spool directory 
system status file 
request status file 


SEE ALSO 

uucp(lC). 
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NAME 

uuto, uupick - public HP-UX-to-HP-UX system file copy 
SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ -s system ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Uuto sends source-files to destination. Uuto uses the uucp(lC) facility to send files, while it 
allows the local system to control the file access. A source-file name is a path name on your 
machine. Destination has the form: 


system! user 

where system is taken from a list of system names that uucp knows about (see uuname{lC)). 
Logname is the login name of someone on the specified system. 

Two options are available: 


-p Copy the source file into the spool directory immediately, and send the copy. 

-m Send mail to the requester when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR on system, where PUBDIR is 
the UUCP public directory (/usr/spool/uucppublic). Specifically the files are sent to 

PUBDIR/receive/wser/ mysystem/^les. 

The recipient is notified by mail{l) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the recipient. Specifically, uupick searches PUB¬ 
DIR for files destined for the user. For each entry (file or directory) found, the following message 
is printed on the standard output: 

from system: [file file-name] [dir dirname] ? 

Uupick then reads a line from the standard input to determine the disposition of the file: 
<new-line> Go on to next entry, 

d Delete the entry. 

m [ dir ] Move the entry to named directory dir (current directory is default). Note 

that, if the current working directory is desired for dir, you should not specify 
any parameter with m. A construction like m. is erroneous, and results in loss 
of data. 


a [ dir ] 


Same as m except move all the files sent from system. 


p Print the contents of the file, 

q Stop. 


EOT (control-d) Same as q. 

I command Escape to the shell to do command. 

* Print a command summary. 


Uupick invoked with the -ssystem option will only search the PUBDIR for files sent from system. 


FILES 

PUBDIR/usr/spool/uucppublic public directory 
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NOTES 

In order to send files that begin with a dot (e.g., .profile) the files must by qualified with a dot. 
For example: .profile, .prof*, .profil? are correct; whereas *prof*, ?profile are incorrect. 


SEE ALSO 

mail(l), uuclean(lM), uucp(lC), uulog(lC), uuname(lC), uustat(lC), uux(lC). 
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NAME 

uux - HP-UX-to-HP-UX system command execution 

SYNOPSIS 

uux [ options ] command-string 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Uux will gather zero or more files from various systems, execute a command on a specified system 
and then send standard output to a file on a specified system. Note that, for security reasons, 
many installations will limit the list of commands executable on behalf of an incoming request 
from uux. Many sites will permit little more than the receipt of mail (see mail{l)) via uux. 

The command string is made up of one or more arguments that look like a Shell command line, 
except that the command and file names may be prefixed by system-namel. A null system-name 
is interpreted as the local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by '^xxx where xxx is a login name on the specified system and is 
replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

As an example, the command 

uux "!diff usg!/usr/dan/fl pwba!/a4/dan/fl > Ifl.diff" 

will get the fl files from the “usg” and “pwba” machines, execute a diff command and put the 
results in fl.difF in the local directory. 

Any special shell characters such as <>;| should be quoted either by quoting the entire 
command-string^ or quoting the special characters as individual arguments. 

Uux will attempt to get all files to the execution system. For files which are output files, the file 
name must be escaped using parentheses. For example, the command 

uux aluucp b!/usr/file \(c!/usr/file\) 

will send a uucp command to system “a” to get /usr/file from system “b” and send it to system 
“c”. 

Uux will notify you if the requested command on the remote system was disallowed. The 
response comes by remote mail from the remote machine. The amount of mail notification can be 
reduced with the -z option, which notifies the remote system only if the command failed. 
Notification can be disabled totally with the -n option. Executable commands are listed in 
/usr/lib/uucp/L.cmds on the remote system. The format of the L.cmds file is: 

cmd,machinel ,machine2,... 

If no machines are specified, then any machine can execute cmd. If machines are specified, only 
the listed machines can execute cmd. If the desired command is not listed in L.sys then no 
machine can execute that command. 

Redirection of standard input and output is usually restricted to files in PUBDIR. Directories into 
which redirection is allowed must be specified in /usr/lib/uucp/USERFILE by the system 
administrator. See the HP-UX System Administrator Guide for details. 

The following options are interpreted by uux: 
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The standard input to uux is made the standard input to the command-string. 

-n Send no notification to user. 

-z Send notification only of failures to user. 

-mfile Report status of the transfer in file. If file is omitted, send mail to the requester when the 
copy is completed. 

-j Control writing of the uucp }oh number to standard output. 

-r Queue job but do not start the file transfer process. By default a file transfer process is 
started each time uux is evoked. 

Uux associates a job number with each request. This job number can be used by uustat to obtain 
status or terminate the job. 

The environment variable JOBNO and the -j option are used to control the listing of the uux job 
number on standard output. If the environment variable JOBNO is undefined of set to OFF, the 
job number will not be listed (default). If uuco is then invoked with the -j option, the job number 
will be listed. If the environment variable JOBNO is set to ON and is exported, a job number 
will be written to standard output each time uux is invoked. In this case, the -j option will 
suppress output of the job number. 

FILES 

/usr/spool/uucp spool directory 

/usr/spool/uucppublic public directory (PUBDIR) 

/usr/lib/uucp/* other data and programs 

SEE ALSO 

mail(l), uuclean(lM), uucp(lC). 

BUGS 

Only the first command of a shell pipeline may have a system-namel. All other commands are 
executed on the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. The shell 
tokens << and >> are not implemented. 

Any excess characters are ignored. 
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NAME 

val - validate SCCS file 

SYNOPSIS 

val - 

val [-s] [-rSID] [-mname] [-ytype] files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

Val determines if the specified file is an SCCS file meeting the characteristics specified by the 
optional argument list. Arguments to val may appear in any order. The arguments consist of 
keyletter arguments, which begin with a and named files. 

Val has a special argument, which causes reading of the standard input until an end-of-file 
condition is detected. Each line read is independently processed as if it were a command line 
argument list. 

Val generates diagnostic messages on the standard output for each command line and file pro¬ 
cessed, and also returns a single 8-bit code upon exit as described below. 

The keyletter arguments are defined as follows. The effects of any keyletter argument apply 
independently to each named file on the command line. 

-s The presence of this argument silences the diagnostic message normally 

generated on the standard output for any error that is detected while pro¬ 
cessing each named file on a given command line. 

-rSID The argument value SID {SCCS /Dentification String) is an SCCS delta 

number. A check is made to determine if the SID is ambiguous (e. g., rl is 
ambiguous because it physically does not exist but implies 1.1, 1.2, etc., 
which may exist) or invalid (e. g., rl.O or rl.1.0 are invalid because neither 
case can exist as a valid delta number). If the SID is valid and not ambi¬ 
guous, a check is made to determine if it actually exists. 

-mname The argument value name is compared with the SCCS %M% keyword in 

file. 

-ytype The argument value type is compared with the SCCS %Y% keyword in file. 

The 8-bit code returned by val is a disjunction of the possible errors, i. e., can be interpreted as a 
bit string where (moving from left to right) set bits are interpreted as follows: 

bit 0 = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 

bit 2 = corrupted SCCS file; 

bit 3 = cannot open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %Y%, -y mismatch; 

bit 7 = %M%, -m mismatch; 

Note that val can process two or more files on a given command line and in turn can process mul¬ 
tiple command lines (when reading the standard input). In these cases an aggregate code is 
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returned - a logical OR of the codes generated for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l). 

DIAGNOSTICS 

Use help{l) for explanations. 

BUGS 

Val can process up to 50 files on a single command line. Any number above 50 will produce a 
fatal error. 


Hewlett-Packard 


July 2, 1985 



VI(1) 


VI(1) 


NAME 

vi - screen-oriented (visual) display editor based on ex 

SYNOPSIS 

vi [ -t tag ] [ -r file ] [ -1 ] [ -wn ] [ -R ] [ -\-command ] name ... 

view [ -t tag ] [ -r file ][-!][ -wn ] [ -R ] [ -{-command ] name ... 

vedit [ -t tag ] [ -r file ][-!][ -wn ] [ -R ] [ -{-command ] name ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Remarks: The decryption facilities provided by this software are under control by the United 
States Government and cannot be exported without special licenses. These capabilities 
are considered an HP-UX/OPTIONAL feature, and can be sold only to domestic cus¬ 
tomers at this time. 

DESCRIPTION 

Vi (visual) is a display-oriented text editor based on an underlying line editor ex{\). It is possi¬ 
ble to use the command mode of ex from within vi and vice-versa. 

When using w, changes you make to the file are reflected in what you see on your terminal screen. 
The position of the cursor on the screen indicates the position within the file. The Vi Quick 

Reference card, the Introduction to Display Editing with Vi and the Ex Reference Manual pro¬ 

vide full details on using vi. 

INVOCATION 

The following invocation options are interpreted by vi: 

-t tag Edit the file containing the tag and position the editor at its definition. 

-rfile Recover file after an editor or system crash. If file is not specified a list of all 

saved files will be printed. 

-1 LISP mode; indents appropriately for lisp code, the () {} [[ and ]] commands in 

vi and open are modified to have meaning for lisp . 

-wn Set the default window size to n. This is useful when using the editor over a slow 

speed line. 

-R Read only mode; the readonly flag is set, preventing accidental overwriting of 

the file. 

-{-command The specified ex command is interpreted before editing begins. 

The name argument indicates files to be edited. 

The view invocation is the same as vi except that the readonly flag is set. 

The vedit invocation is intended for beginners. The report flag is set to 1, and the showmode 
and novice flags are set. These defaults make it easier to get started learning the editor. 

"VI MODES" 

Command Normal and initial mode. Other modes return to command mode upon comple¬ 
tion. ESC (escape) is used to cancel a partial command. 

Input Entered byaiAIoOcCsSR. Arbitrary text may then be entered. Input 

mode is normally terminated with ESC character, or abnormally with interrupt. 

Last line Reading input for : / ? or !; terminate with CR to execute, interrupt to cancel. 

COMMAND SUMMARY 
Sample commands 

•«— i t arrow keys move the cursor 

h j k 1 same as arrow keys 
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labcESC 

insert text abc 

cv/newESC 

change word to new 

easESC 

pluralize word 

X 

delete a character 

dw 

delete a word 

dd 

delete a line 

3dd 

delete 3 lines 

u 

undo previous change 

ZZ 

exit vi, saving changes 

:q!CR 

quit, discarding changes 

/textCK 

search for text 

U D 

scroll up or down 

:ex cmdCR 

any ex or ed command 


Counts before vi commands 

Numbers may be typed as 
line/column number 
scroll amount 
repeat effect 


Interrupting, canceling 


ESC 

end insert or incomplete cmd 

? 

(delete or rubout) interrupts 

L 

reprint screen if "? scrambles 

R 

reprint screen if "L is —^ key 

File manipulation 

:wCR 

write back changes 

:qCR 

quit 

:q!CR 

quit, discard changes 

:e nomeCR 

edit file name 

:e!CR 

reedit, discard changes 

:e + nomeCR 

edit, starting at end 

:e +nCR 

edit starting at line n 

:e #CR 

edit alternate file 

:w nameCR 

synonym for :e # 
write file name 

:w! nameCR 

overwrite file name 

:shCR 

run shell, then return 

;!cmdCR 

run cmd, then return 

:nCR 

edit next file in arglist 

:n argsCH 

specify new arglist 

G 

show current file and line 

:ta ta^K 

to tag file entry tag 

1 

:ta, following word is tag 


In general, any ex or ed command (such as substitute or global) may be typed, preceded by a 
colon and followed by a CR. 


a prefix to some commands. They are interpreted in one of these ways. 

z G I 
D U 

most of the rest 
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Positioning within file 


F 

forward screen 

B 

backward screen 

D 

scroll down half screen 

"U 

scroll up half screen 

G 

go to specified line (end default) 

/pat 

next line matching pat 

?pat 

prev line matching pat 

n 

repeat last / or ? 

N 

reverse last / or ? 

/pat/+n 

noth line after pat 

?pat?~n 

noth line before pat 

11 

next section/function 

[[ 

previous section/function 

( 

beginning of sentence 

) 

end of sentence 

{ 

beginning of paragraph 

} 

end of paragraph 

% 

find matching ( ) { or } 

Adjusting the 

screen 

L 

clear and redraw 

R 

retype, eliminate @ lines 

zCR 

redraw, current at window top 

z-CR 

... at bottom 

z.CR 

... at center 

/pat/z-CK pat line at bottom 

zn.CR 

use n line window 

E 

scroll window down 1 line 

Y 

scroll window up 1 line 

Marking and returning 


move cursor to previous context 


... at first non-white in line 

mx 

mark current position with letter x 

' X 

move cursor to mark x 

' X 

... at first non-white in line 

Line positioning 

H 

top line on screen 

L 

last line on screen 

M 

middle line on screen 

+ 

next line, at first non-white 

- 

previous line, at first non-white 

CR 

return, same as + 

i or j 

next line, same column 

t or k 

previous line, same column 
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Character positioning 



first non white 

0 

beginning of line 

$ 

end of line 

h or —► 

forward 

1 or <— 

backwards 

H 

same as <— 

space 

same as —»■ 

fx 

find X forward 

Fa: 

f backward 

ta: 

upto X forward 

Ta: 

1 

back upto X 
repeat last f F t or T 
inverse of ; 
to specified column 

% 

find matching ( { ) or } 

Words, sentences, paragraphs 

w 

word forward 

b 

back word 

e 

end of word 

) 

to next sentence 

} 

to next paragraph 

( 

back sentence 

{ 

back paragraph 

w 

blank delimited word 

B 

back W 

E 

to end of W 

Commands for LISP Mode 

) 

Forward s-expression 

} 

... but do not stop at atoms 

( 

Back s-expression 

{ 

... but do not stop at atoms 

Corrections during insert 

H 

erase last character 

W 

erase last word 

erase 

your erase, same as "H 

kill 

your kill, erase input this line 

\ 

quotes "H, your erase and kill 

ESC 

ends insertion, back to command 


interrupt, terminates insert 

D 

backtab over autoindent 

T D 

kill autoindent, save for next 

0 D 

... but at margin next also 

-V 

quote non-printing character 

Insert and replace 

a 

append after cursor 

i 

insert before cursor 

A 

append at end of line 

I 

insert before first non-blank 

o 

open line below 

O 

open above 

ra: 

replace single char with x 
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R^ex^ESC replace characters 

Operators 

Operators are followed by a cursor motion, and affect all text that would have been moved over. 
For example, since w moves over a word, dw deletes the word that would be moved over. Dou¬ 
ble the operator, e.g. dd to affect v/hole lines, 
d delete 

c change 

y yank lines to buffer 

< left shift 

> right shift 

! filter through command 

= indent for LISP 

Miscellaneous Operations 

C change rest of line (c$) 

D delete rest of line (d$) 

s substitute chars (cl) 

S substitute lines (cc) 

J join lines 

X delete characters (dl) 

X ... before cursor (dh) 

Y yank lines (yy) 

Yank and Put 

Put inserts the text most recently deleted or yanked. However, if a buffer is named, the text in 
that buffer is put instead, 
p put back text after cursor 

P put before cursor 

"xp put from buffer x 

"ay yank to buffer x 

"xd delete into buffer x 

Undo, Redo, Retrieve 

u undo last change 

U restore current line 

repeat last change 
"dp retrieve cfth last delete 

AUTHOR 

Vi and ex were developed by The University of California, Berkeley California, Computer Science 
Division, Department of Electrical Engineering and Computer Science. 

SEE ALSO 

ex (1). 

Vi tutorial in HP-UX Concepts and Tutorials. 

WARNINGS AND BUGS 

Software tabs using " T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals do not make use of insert and delete character opera¬ 
tions in the terminal. 
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NAME 

vis, inv - make unprintable characters in a file visible or invisible 

SYNOPSIS 

vis [ -n ] [ -s ] [ -u ] [ -'w ] file ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: HP 

Native Language Support: 

8-bit and 16-bit data, customs, messages. 

DESCRIPTION 

Vis reads characters from each file in sequence and writes them to the standard output, convert¬ 
ing those which are not printable into a visible form. Inv performs the inverse function, reading 
printable characters from each file and writing them, returned if appropriate to non-printable 
form, to standard out. 

Non-printable characters are represented using C-like escape conventions: 

\\ backslash 

\b backspace 

\e escape 

\f form-feed 

\n new-line 

\r carriage return 

\s space 

\t horizontal tab 

\v vertical tab 

\n the 8-bit character whose ASCII code is the 3-digit octal number n. 

\xn the 8-bit character whose ASCII code is the 2-digit hexidecimal number n. 

Space, horizontal tab, and new line may be treated as printable (and therefore passed unscathed 
to the output) or non-printable dependent on the options selected. Backslash, although printable, 
is expanded by vis, to a pair of backslashes so that when passed back through inv, it can be 
mapped back to a single backslash. 

If no input file is given, or if the argument - is encountered, vis and inv read from the standard 
input file. 

The options are: 

-n causes new-line, space, and horizontal tab to be treated as non-printable charac¬ 

ters. Thus vis expands them visibly as \n, \s, and \t, rather passing them 
directly to the output. Inv discards these character, expecting only the printable 
expansions. New-line characters are inserted by vis every 16 characters so that 
the output will be in form acceptable for most editors. 

-s makes vis and inv silent about non-existent files, identical input and output, and 
write errors. Normally, no input file may be the same as the output file unless it 
is a special file. 

-t treats horizontal tab and space as non-printable characters, in the same manner 
in which -n options treats them. 

-u causes output to be unbuffered (character-by-character); normally, output is 
buffered. 

-X causes vis output to be in hexidecimal form rather than the default octal form. 
Either form is accepted to inv as input. 
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EXAMPLE 

If you encounter a file whose contents are unknown-perhaps binary or text-you can take a quick 
peek into it without jeopordizing your terminal: 

vis -n file I head 

This will safely show the first 160 bytes of the file. 

SEE ALSO 

cat(l), echo(l), od(l). 

WARNING 

Command formats such as 
vis filel file2 >filel 

will cause the original data in filel to be lost. 
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NAME 

wait - await completion of process 

SYNOPSIS 

wait 

HP-UX COMPATIBILITY 

Level: HP-UX/NUCLEUS 

Origin: System III 

DESCRIPTION 

Wait until all processes started with &; have completed, and report on abnormal terminations. 

Because the wait{2) system call must be executed in the parent process, the shell itself executes 
wait, without creating a new process. 

SEE ALSO 

sh(l), wait(2) 

BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the shell, and thus cannot be 
waited for. 
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NAME 

wc - word, line, and character count 

SYNOPSIS 

wc [ -Iwc ] [ names ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages. 

DESCRIPTION 

Wc counts lines, words, and characters in the named files, or in the standard input if no names 
appear. It also keeps a total count for all named files. A word is a maximal string of characters 
delimited by spaces, tabs, or new-lines. 

The options 1, w, and c may be used in any combination to specify that a subset of lines, words, 
and characters are to be reported. The default is -Iwc. 

When names are specified on the command line, they will be printed along with the counts. 

BUGS 

Wc counts the number of new-lines to determine the line count. If an ASCII text file has a final 
line that is not terminated with a new-line character, the count will be off by one. 

If there are very many characters, words, and/or lines in an input file, the output may be hard to 
read. This is because wc reserves a fixed column width for each count. 
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NAME 

what - identify files for SCCS information 

SYNOPSIS 

what files 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System III 

DESCRIPTION 

What searches the given files for all occurrences of the pattern that get{l) substitutes for %Z% 
(this is @(#) at this printing) and prints out what follows until the first ", >, new-line, \, or null 
character. For example, if the C program in file f.c contains 

char ident[] = "@(#)identification information"; 
and f.c is compiled to yield f.o and a.out, then the command 


what f.c 

f.o a.out 

will print 


f.c: 

identification information 

f.o: 

identification information 

a.out: 

identification information 


What is intended to be used in conjunction with the SCCS command get{l), which automatically 
inserts identifying information, but it can also be used where the information is inserted manually. 

SEE ALSO 

get(l), help(l). 

SCCS User’s Guide in HP-UX Concepts and Tutorials. 

DIAGNOSTICS 

Use help(l) for explanations. 

BUGS 

It’s possible that an unintended occurrence of the pattern @(#) could be found just by chance, 
but this causes no harm in nearly all cases. 
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NAME 

whereis - locate source, binary, and/or manual for program 
SYNOPSIS 

whereis [ -sbm ] [ -u ] [ -SBM dir ... -f ] name ... 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDAftD 

Origin: UCB 

DESCRIPTION 

Whereis locates source/binary and manuals sections for specified files. The supplied names are 
first stripped of leading pathname components and any (single) trailing extension of the form 
".ext", e.g. ".c". Prefixes of "s." resulting from use of SCCS are also dealt with. WHereis then 
attempts to locate the desired program in a list of standard places. If any of the -b, -s or -m 
fiags are given then whereis searches only for binaries, sources or manual sections respectively (or 
any two thereof). The -u flag may be used to search for unusual entries. A file is said to be 
unusual if it does not have one entry of each requested type. Thus "whereis -m -u *" asks for 
those files in the current directory which have no documentation. 

Finally, the -B -M and -S flags may be used to change or otherwise limit the places where 
whereis searches. The -f file flag is used to terminate the last such directory list and signal the 
start of file names. 

EXAMPLE 

The following finds all the files in /usr/bin which are not documented in /usr/man/manl with 
source in /usr/src/cmd: 

cd /usr/bin 

whereis -u -M /usr/man/manl -S /usr/src/cmd -f * 

FILES 

/usr/src/* 

/bin, /etc, /lib, /usr/{bin, games, lib} 

/usr/man/* 

/usr/local/{man/*, bin, games, include, lib} 

/usr/contrib/{man/*, bin, games, include, lib} 

BUGS 

Since the program uses chdir{2) to run faster, pathnames given with the -M -S and -B must be 
full; i.e. they must begin with a "/". 
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NAME 

who - who is on the system 

SYNOPSIS 

who [-uTHlpdbrtasq] [ file ] 
who am i 
who am I 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Who can list the user’s name, terminal line, login time, elapsed time since activity occurred on the 
line, and the process-ID of the command interpreter (shell) for each current HP-UX system user. 
It examines the /etc/utmp file to obtain its information. If file is given, that file is examined. 
Usually, file will be /etc/wtmp, which contains a history of all the logins since the file was last 
created. 

Who with the am i or am I option identifies the invoking user. 

Except for the default -s option, the general format for output entries is: 
name [state] line time activity pid [comment] [exit] 

With options, who can list logins, logoflFs, reboots, and changes to the system clock, as well as 
other processes spawned by the init process. These options are: 

-u This option lists only those users who are currently logged in. The name is the user’s login 
name. The line is the name of the line as found in the directory /dev. The time is the 
time that the user logged in. The activity is the number of hours and minutes since 
activity last occurred on that particular line. A dot (.) indicates that the terminal has 
seen activity in the last minute and is therefore “current”. If more than twenty-four hours 
have elapsed or the line has not been used since boot time, the entry is marked old. This 
field is useful when trying to determine whether a person is working at the terminal or not. 
The pid is the process-ID of the user’s shell. The comment is the comment field associated 

with this line as found in /etc/inittab (see inittab{4)). This can contain information 

about where the terminal is located, the telephone number of the dataset, type of terminal 

if hard-wired, etc. 

-T This option is the same as the -u option, except that the state of the terminal line is 
printed. The state describes whether someone else can write to that terminal. A + 
appears if the terminal is writable by anyone; a - appears if it is not. Root can write to all 
lines having a + or a - in the state field. If a bad line is encountered, a ? is printed. 

-1 This option lists only those lines on which the system is waiting for someone to login. The 
name field is LOGIN in such cases. Other fields are the same as for user entries except 
that the state field does not exist. 

-H This option will print column headings above the regular output. 

-q This is a quick who, displaying only the names and the number of users currently logged 

on. When this option is used, all other options are ignored. 

-p This option lists any other process which is currently active and has been previously 
spawned by init. The name field is the name of the program executed by init as found in 
/etc/inittab. The state, line, and activity fields have no meaning. The comment field 
shows the id field of the line from /etc/inittab that spawned this process. See inittab(4). 
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-d This option displays all processes that have expired and not been respawned by init. The 
exit field appears for dead processes and contains the termination and exit values (as 
returned by wait{2))^ of the dead process. This can be useful in determining why a process 
terminated. 

-b This option indicates the time and date of the last reboot. 

-r This option indicates the current run-level of the init process. The last three fields contain 

the current state of init, the number of times that that state has been previously entered, 
and the previous state. These fields are updated each time init changes to a different run 
state. 

-t This option indicates the last change to the system clock (via the date{l) command) by 
root. See 5w(l). 

-a This option processes /etc/utmp or the named file with all options turned on. 

-s This option is the default and lists only the name, line, and time fields. 

FILES 

/etc/utmp 

/etc/wtmp 

/etc/inittab 

SEE ALSO 

date(l), login(l), mesg(l), su(l), init(lM), wait(2), inittab(5), utmp(5). 
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NAME 

whoami - print effective current user id 

SYNOPSIS 

whoami 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: UCB 

DESCRIPTION 

Whoami prints who you are. It works even if you are su’d, while ‘who am i’ does not since it uses 
/etc/utmp. 

FILES 

/etc/passwd Name data base 

SEE ALSO 

who (1) 
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NAME 

write - interactively write (talk) to another user 

SYNOPSIS 

write user [ line ] 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

Native Language Support: 

8-bit data, customs, messages. 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Write copies lines from your terminal to that of another user. When first called, it sends the mes¬ 
sage: 

Message from yourname (tty??) [ date ]... 

to the person you want to talk to. When it has successfully completed the connection, it also 
sends two bells to your own terminal to indicate that what you are typing is being sent. 

The recipient of the message should write back at this point. Communication continues until an 
end of file is read from the terminal, an interrupt is sent, or the recipient has executed "mesg n". 
At that point write writes EOT on the other terminal and exits. 

If you want to write to a user who is logged in more than once, the line argument may be used to 
indicate which line or terminal to send to (e.g., ttyOO); otherwise, the first writable instance of 
the user found in / etc /utmp is assumed and the following message posted: 

wser is logged on more than one place. 

You are connected to "terminal". 

Other locations are: 
terminal 

Permission to write may be denied or granted by use of the mesg(l) command. Writing to others 
is normally allowed by default. Certain commands, in particular nroff(l) and pr{l) disallow mes¬ 
sages in order to prevent interference with their output. However, if the user has super-user per¬ 
missions, messages can be forced onto a write-inhibited terminal. 

If the character ! is found at the beginning of a line, write calls the shell to execute the rest of the 
line as a command. 

The following protocol is suggested for using write: when you first write to another user, wait for 
them to write back before starting to send. Each person should end a message with a distinctive 
signal (i.e., (o) for “over”) so that the other person knows when to reply. The signal (oo) (for 
“over and out”) is suggested when conversation is to be terminated. 

FILES 

/etc/utmp to find user 
/bin/sh to execute ! 

SEE ALSO 

mail(l), mesg(l), nroff(l), pr(l), sh(l), who(l). 

DIAGNOSTICS 

“wser is not logged on^^ if the person you are trying to write to is not logged on. 

Permission denied^' if the person you are trying to write to denies that permission (with mesg). 

“ Warning: cannot respond, set mesg -?/” if your terminal is set to mesg n and the recipient can¬ 
not respond to you. 
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“Can no longer write to user’’’’ if the recipient has denied permission (mesg n) after you had 
started writing. 
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NAME 

xargs - construct argument list(s) and execute command 

SYNOPSIS 

xargs [flags] [ command [initial-arguments] ] 

HP-UX COMPATIBILITY 

Level; HP-UX/STANDARD 

Origin: System V 

Remarks: Not supported on the Integral Personal Computer. 

DESCRIPTION 

Xargs combines the flxed initial-arguments with arguments read from standard input to execute 
the specifled command one or more times. The number of arguments read for each command 
invocation and the manner in which they are combined are determined by the flags specifled. 

Command, which may be a shell file, is searched for, using one’s $PATH. If command is omitted, 

/bin/echo is used. 

Arguments read in from standard input are defined to be contiguous strings of characters delim¬ 
ited by one or more blanks, tabs, or new-lines; empty lines are always discarded. Blanks and tabs 
may be embedded as part of an argument if escaped or quoted. Characters enclosed in quotes 
(single or double) are taken literally, and the delimiting quotes are removed. Outside of quoted 
strings a backslash (\) will escape the next character. 

Each argument list is constructed starting with the initial-arguments, followed by some number 
of arguments read from standard input (Exception: see -i flag). Flags -i, -1, and -n determine 
how arguments are selected for each command invocation. When none of these flags are coded, 
the initial-arguments are followed by arguments read continuously from standard input until an 
internal buffer is full, and then command is executed with the accumulated args. This process is 
repeated until there are no more args. When there are flag conflicts (e.g., -1 vs. -n), the last flag 
has precedence. Flag values are: 

-Inumber Command is executed fof each non-empty number lines of arguments from 

standard input. The last invocation of command will be with fewer lines of 
arguments if fewer than number remain. A line is considered to end with 
the first new-line unless the last character of the line is a blank or a tab; a 
trailing blank/tab signals continuation through the next non-empty line. 
If number is omitted, 1 is assumed. Option -x is forced. 

-ireplstr Insert mode: command is executed for each line from standard input, tak¬ 

ing the entire line as a single arg, inserting it in initial-arguments for each 
occurrence of replstr. A maximum of 5 arguments in initial-arguments 
may each contain one or more instances of replstr. Blanks and tabs at the 
beginning of each line are thrown away. Constructed arguments may not 
grow larger than 255 characters, and option -x is also forced. {} is 
assumed for replstr if not specified. 

-nnumber Execute command using as many standard input arguments as possible, up 

to number arguments maximum. Fewer arguments will be used if their 
total size is greater than size characters, and for the last invocation if there 
are fewer than number arguments remaining. If option -x is also coded, 
each number arguments must fit in the size limitation, else xargs ter- 
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rninates execution. 

Trace mode: The command and each constructed argument list are echoed 
to file descriptor 2 just prior to their execution. 

Prompt mode: The user is asked whether to execute command each invo¬ 
cation. Trace mode (-t) is turned on to print the command instance to be 
executed, followed by a ?... prompt. A reply of y (optionally followed by 
anything) will execute the command; anything else, including just a car¬ 
riage return, skips that particular invocation of command. 

Causes xargs to terminate if any argument list would be greater than size 
characters; -x is forced by the options -i and -1. When neither of the 
options -i, -1, or -n are coded, the total length of all arguments must be 
within the size limit. 

The maximum total size of each argument list is set to size characters; size 
must be a positive integer less than or equal to 470. If -s is not coded, 470 
is taken as the default. Note that the character count for size includes one 
extra character for each argument and the count of characters in the com¬ 
mand name. 

-eeofstr Eofstr is taken as the logical end-of-file string. Underbar (_) is assumed 

for the logical EOF string if -e is not coded. The value -e with no eofstr 
coded turns off the logical EOF string capability (underbar is taken 
literally). Xargs reads standard input until either end-of-file or the logical 
EOF string is encountered. 

Xargs will terminate if either it receives a return code of -1 from, or if it cannot execute, com¬ 
mand. When command is a shell program, it should explicitly exit (see sh{l)) with an appropri¬ 
ate value to avoid accidentally returning with -1. 

EXAMPLES 

The following will move all files from directory $1 to directory $2, and echo each move command 
just before doing it: 

Is $1 I xargs -i -t mv $!/{} $2/{} 

The following will combine the output of the parenthesized commands onto one line, which is then 
echoed to the end of file log: 

(logname; date; echo $0 $*) I xargs >>log 

The user is asked which files in the current directory are to be archived and archives them into 
arch (1.) one at a time, or (2.) many at a time. 

1. Is I xargs -p -1 ar r arch 

2. Is 1 xargs -p -1 I xargs ar r.arch 

The following will execute diff(l) with successive pairs of arguments originally typed as shell 
arguments: 

echo $* I xargs -n2 diff 

SEE ALSO 

sh(l). 

DIAGNOSTICS 

Self-explanatory. 
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NAME 

yacc - yet another compiler-compiler 

SYNOPSIS 

yacc [ -vdlt ] grammar 

HP-UX COMPATIBILITY 

Level: HP-UX/STANDARD 

Origin: System V 

DESCRIPTION 

Yacc converts a context-free grammar into a set of tables for a simple automaton which executes 
an LR(1) parsing algorithm. The grammar may be ambiguous; specified precedence rules are used 
to break ambiguities. 

The output file, y.tab.c, must be compiled by the C compiler to produce a program yyparse. 
This program must be loaded with the lexical analyzer program, yylex, as well as main and yyer¬ 
ror, an error handling routine. These routines must be supplied by the user; lex{l) is useful for 
creating lexical analyzers usable by yacc. 

If the -V flag is given, the file y.output is prepared, which contains a description of the parsing 
tables and a report on conflicts generated by ambiguities in the grammar. 

If the -d flag is used, the file y.tab.h is generated with the #define statements that associate the 
yacc-assigned “token codes” with the user-declared “token names”. This allows source files other 
than y.tab.c to access the token codes. 

If the -1 flag is given, the code produced in y.tab.c will not contain any #line constructs. This 
should only be used after the grammar and the associated actions are fully debugged. This is use¬ 
ful when you intend to compile y.tab.c with the -g option for cdb, since #line constructs should 
not be used in file compiled with —g. (See cc(l), cdb{l)). 

Runtime debugging code is always generated in y.tab.c under conditional compilation control. 
By default, this code is not included when y.tab.c is compiled. However, when yacc^s -t option is 
used, this debugging code will be compiled by default. Independent of whether the -t option was 
used, the runtime debugging code is under the control of YYDEBUG, a pre-processor symbol. If 
YYDEBUG has a non-zero value, then the debugging code is included. If its value is zero, then 
the code will not be included. The size and execution time of a program produced without the 
runtime debugging code will be smaller and slightly faster. 

FILES 

y.output 
y.tab.c 
y.tab.h 
yacc.tmp, 

yacc.debug, yacc.acts 
/usr/lib/yaccpar 

SEE ALSO 

lex(l), malloc(3X). 

LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 

YACC - Yet Another Compiler Compiler in HP-UX: Selected Articles. 

DIAGNOSTICS 

The number of reduce-reduce and shift-reduce conflicts is reported on the standard error output; 
a more detailed report is found in the y.output file. Similarly, if some rules are not reachable 
from the start symbol, this is also reported. 

BUGS 

Because file names are fixed, at most one yacc process can be active in a given directory at a time. 
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PERMUTED INDEX 


[ . test(l) 

a641 . a641(3C) 

abort . abort(3C) 

abs . abs(3C) 

absolute value, floating point . floor(3M) 

absolute value, integer. abs(3C) 

access . access(2) 

access long integer data in machine-independent manner . sputl(3X) 

access modes, change memory segment . memchmd(2) 

access terminfo database . tput(l) 

access utmp file entry . getut(3C) 

accessing discs, description of blocked/unblocked disc interface . disc(4) 

accounting commands, miscellaneous . acct(lM) 

accounting commands, overview . acct(lM) 

accounting commands, process . acctcom(l) 

accounting: connect-time . acctcon(lM) 

accounting, convert binary wtmp records to ASCII . fwtmp(lM) 

accounting, correct time/date stamps on wtmp records . fwtmp(lM) 

accounting: daily . runacct(lM) 

accounting file format . acct(5) 

accounting files: merge or add total . acctmerg(lM) 

accounting: generate disc usage data by user ID . diskusg(lM) 

accounting: process accounting . acctprc(lM) 

accounting, record login names and times . utmp(5) 

accounting records command summary . acctcms(lM) 

accounting: shell procedures . acctsh(lM) 

acctcms . acctcms(lM) 

acctcom . acctcom(l) 

acctcon . acctcon(lM) 

acctdisk . acct(lM) 

acctdusg . acct(lM) 

acctmerg . acctmerg(lM) 

accton . acct(lM) 

acctprc . acctprc(lM) 

acctsh . acctsh(lM) 

acctwtmp. acct(lM) 

acos . trig(3M) 

activity, terminate all current system activity . shutdown(IM) 

adb . adb(l) 

add a swap device for interleaved paging/signalling . swapon(2) 

add backing store devices. vson(2) 

add or change environment value . putenv(3C) 

add or merge total accounting files . acctmerg(IM) 

address space, allocate and free . memallc(2) 

address space, lock/unlock for process . memlck(2) 

addresses, get for program . end(3C) 

adjust . adjust(l) 

admin . admin(l) 

advance. regexp(7) 

advise OS about segment reference patterns . memadvise(2) 

alarm. alarm (2) 

alarm clock, set . alarm(2) 

allocate a block of memory . malloc(3C) 

allocate and free address space . memallc(2) 

allocate backing store space to backing store device. vsadv(2) 

allocate data segment space for process . brk(2) 
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Permuted Index 


a.out file format, description of . a.out(5) 

append to an existing operating system . oscp(lM) 

appointments, reminder service for . calendar(l) 

ar . 

arc cosine function . trig(3M) 

arc sine function . trig{3M) 

arc tangent function . trig(3M) 

archive, conversion to new format . arcv(l) 

archive file format, description of. ar(5) 

archive file format, description of cpio archive file format . cpio(5) 

archive files on tape. tar(l) 

archive library, find ordering relation for . lorder(l) 

archive, table of contents format description . ranlib(5) 

archives and libraries, create and maintain . ar(l) 

archives, copy out to media . cpio(l) 

archives, extract archive files from media . cpio(l) 

arcv . arcv(l) 

argument list handling facility, variable . varargs(7) 

argv, get next option letter from . getopt(3C) 

array, allocate memory space for . malloc(3C) 

array, print formatted data into. printf(3S) 

array, read and format data from. scanf(3S) 

as . as(l) 

asa . asa(l) 

ASA carriage control characters, interpret . asa(l) 

ascii . ascii(7) 

ASCII, convert base 64 ASCII to long integer. a641(3C) 

ASCII, convert binary wtmp records to . fwtmp(lM) 

ASCII, convert floating point value to . ecvt(3C) 

ASCII, convert non-ASCII to ASCII . conv(3C) 

ASCII, convert to numbers . atof(3C) 

asctime. ctime(3C) 

asin . trig(3M) 

assembler for MC68000 . as(l) 

assembler/linker executable output file, description of. a.out(5) 

assembly language, translate . atrans(l) 

assert . assert (3X) 

assign buffering to an open file . setbuf(3S) 

assistance, get for SCCS . help(l) 

assure sufficient signal stack space . sigspace(2) 

asynchronous terminal emulation. aterm(l) 

at . at(l) 

atan. trig(3M) 

atan2 . trig(3M) 

aterm . aterm(l) 

atoa . atof(3C) 

atof. atof(3C) 

atoi . atof(3C) 

atol . atof(3C) 

atrans . atrans(l) 

attributes, change program’s internal . chatr(l) 

automatically release blocked signals and wait for interrupt . sigpause(2) 

awk . awk(l) 

backing store devices, add/remove device from those available. vson(2) 

backing store devices, allocate backing store space to . vsadv(2) 
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Permuted Index 


backing store usage, advise system about. vsadv(2) 

backspaces and reverse line-feeds, interpret for nroff(l) . col(l) 

backup . backup (IM) 

backup Command Set 80 cartridge tape . tcio(l) 

backup or archive file system . backup (IM) 

banner . banner (1) 

banners, make using large letters . banner(l) 

base-64 ASCII, convert to long integer. a641(3C) 

basename . basename(l) 

baud rate, settings for terminal . tty(4) 

bcheckrc. brc(lM) 

bdiff . bdiff(l) 

Bell file system consistency check and interactive repair . biffsck(l) 

Bell file system, construct . bifmkfs(l) 

Bell file system debugger . biffsdb(l) 

Bell Interchange Format file utilities. bif(5) 

Berkeley compatibility for magnetic tape, description of . mt(4) 

bessel functions . bessel(3M) 

bfs . bfs(l) 

BIF directory, list . bifls(l) 

BIF directory, make. bifmkdir(l) 

BIF file, change mode of . bifchmod(l) 

BIF file copy. bifcp(l) 

BIF files or directories, remove . bifrm(l) 

bifchmod . bifchmod(l) 

bifchown. bifchown(l) 

bifcp . bifcp(l) 

bifdf . bifdf(l) 

biffind. bifRnd(l) 

biffls . biffis(l) 

biffsck. biffsck(l) 

biffsdb. biffsdb(l) 

bifmkdir . bifmkdir(l) 

bifmkfs . bifmkfs(l) 

bifrm. bifrm(l) 

big file scanner. bfs(l) 

binary search on a sorted table . bsearch(3C) 

bit bucket, special file equivalent to . null (4) 

block of memory, allocate . malloc(3C) 

block of memory, change size of . malloc(3C) 

block of memory, deallocate . malloc(3C) 

block signals . sigblock(2) 

block size, find for mounted file system . ustat(2) 

block special file, create. mknod(2), mknod(lM) 

blocked disc interface, description of . disc (4) 

blocked signals, release and wait for interrupt . sigpause(2) 

blocks, find number of free blocks for mounted file system . ustat(2) 

blocks, report number of free disc blocks . df(lM) 

boot area, allocate bytes for . sdfinit(lM) 

boot area, copy OS from one or more SDF boot areas to another . oscp(lM) 

boot area, set or get current settings for system parameters in . uconfig(lM) 

brc . brc(lM) 

break . sh(l) 

break value, get maximum for process . ulimit(2) 

break value, set or get . brk(2) 
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Permuted Index 


break-point debugging, enable for child process. ptrace(2) 

brk . brk(2) 

bsearch . bsearch(3C) 

buffered file I/O package, description of. stdio(3S) 

buffering, assign to open file . setbuf(3S) 

buffers, flush those associated with an open file . fclose(3S) 

byte offset of next I/O operation on file, set . fseek(3S) 

byte swapping. swab(3C) 

C compiler . cc(l) 

C compiler, preprocessor for . cpp(l) 

C flow graph, generate . cflow(l) 

C preprocessor . cpp(l) 

C program checker/verifier . lint(l) 

C program, error message generator for . perror(3C) 

C program formatter . cb(l) 

cache buffers, specify size and number of. uconfig(lM) 

calendar . calendar(1) 

call another UNIX/HP-UX system . cu(l) 

calloc . malloc(3C) 

captoinfo. captoinfo(lM) 

carriage control characters, interpret ASA . asa(l) 

cartridge tape. Command Set 80 utility . tcio(l) 

cartridge tape initialization . mediainit(l) 

cartridge tape, perform input/output from/to. tcio(l) 

cartridge tape, unpack/extract files from Command Set 80 . upm(l) 

cat . cat(l) 

cat, compress, uncompress files . compact(1) 

catman . catman(lM) 

catread . catread(3C) 

cb . cb(l) 

cc . cc(l) 

ccat . compact (1) 

cd . cd(l), sh(l) 

cdc . cdc(l) 

ceil . floor(3M) 

certify file system consistency . fsck(lM) 

certify SDF volume . sdfinit(lM) 

cflow. cflow(l) 

change bars, create file containing. diffmk(l) 

change data segment space allocation . brk(2) 

change delta commentary of SCCS delta . cdc(l) 

change file mode . chmod(l), chmod(2) 

change file owner or group . bifchown(l) 

change file owner or group . chown(l), chown(2) 

change group ID of user. newgrp(l), sh(l) 

change login password . passwd(l) 

change default login shell . chsh(l) 

change memory segment access modes . memchmd(2) 

change mode of a BIF file . bifchmod(l) 

change or add value to environment . putenv(3C) 

change or read real-time priority . rtprio(2) 

change or set real-time priority . rtprio(l) 

change program’s internal attributes . chatr(l) 

change root directory for a command . chroot(lM) 

change root directory for duration of command. chroot(l), chroot(2) 
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Permuted Index 


change SCCS file parameters . 

change size of previously-allocated block of memory . 

change system state . 

change to another user . 

change to different operating system or version . 

change working directory . 

character classification . 

character conversion, lower-case to upper-case . 

character conversion, non-ASCII to ASCII . 

character conversion, upper-case to lower-case . 

character count . 

character, description of special characters in terminal interface 

character, push back into input stream . 

character, read from buffered open file . 

character, search for in string . 

character sets, NLS . 

character size, settings for terminal . 

character special file, create . 

character, write on buffered open file or standard output . 

characters, count number contained in file . 

characters, process characters from regular expression. 

characters, translate into other characters . 

chatr . 

chdir . 

check C program . 

check file for accessibility . 

check file system consistency . 

check integrity of OS in SDF boot area(s) . 

check internal revision numbers of HP-UX files. 

check password and group files . 

checklist, list of file systems to be checked by fsck(lM) . 

chgrp . 

child process, enable break-point debugging of . 

child process, time execution of . 

child process, wait for termination of. 

chmod . 

chown . 

chroot . 

chroot . 

chsh . 

chsys. 

classify characters for NLS . 

clean up uucp spool directory . 

clear. 

clear error indicator on open file . 

clear i-node by zeroing it out . 

clear terminal screen . 

clear x.25 switched virtual circuit . 

clearerr . 

clock . 

clock, set/print time and date . 

close . 

close a file descriptor . 

close group file . 

close or flush a stream . 


. admin(l) 

. malloc(3C) 

. init(lM) 

. su(l) 

. chsys(lM) 

. cd(l), sh(l), chdir(2) 

. ctype(3C) 

. conv(3C) 

. conv(3C) 

. conv(3C) 

. wc(l) 

. tty(4) 

. ungetc(3S) 

. getc(3S) 

. string(3C) 

ascii (7), kana8(7), roman8(7) 

. tty(4) 

. mknod(2), mknod(lM) 

. putc(3S) 

. wc(l) 

. regexp(7) 

. tr(l) 

. chatr(l) 

. chdir(2) 

. lint(l) 

. access(2) 

. fsck(lM) 

. osck(lM) 

. revck(lM) 

. pwck(lM) 

. checklist(5) 

. chown(l) 

. ptrace(2) 

. times(2) 

. sh(l) 

.. chmod(l), chmod(2) 

. chown(l), chown(2) 

. chroot(1), chroot(2) 

. chroot (IM) 

. chsh(l) 

. chsys(lM) 

. nl_ctype(3C) 

. uuclean(lM) 

. clear(l) 

. terror(3S) 

. clri(lM) 

. clear (1) 

. clrsvc(lM) 

. terror (3S) 

. clock(3C) 

. date(l) 

. close(2) 

. close(2) 

. getgrent(3C) 

. fclose(3S) 
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Permuted Index 


close password file . getpwent(3C) 

close pipe between process and command . popen(3S) 

close-on-exec fiag, get/set . fcntl(2) 

clri . clri(lM) 

clrsvc . clrsvc(lM) 

cmp . cmp(l) 

code portability between HP-UX implementations, typedefs for . model(5) 

code segments, specify maximum number of. uconfig(lM) 

col . col(l) 

collating sequence tables, NLS character set . col_seq_8(5), col_seq_16(5) 

collation, non-ASCII string, used by NLS . nl__string(3C) 

colon (:) command . sh(l) 

combine object files into program . ld(l) 

comm . comm(l) 

command, create/close pipe between process and command . popen(3S) 

command, execute from program. system(3S) 

command, execute on another system . uux(l) 

command, execute uucp commands on local system . uuxqt(lM) 

command, execute with different root directory . chroot(l), chroot(2) 

command interpreter, standard . sh(l) 

command line options, parse . getopt(l) 

command, report error information for . err(l) 

command, run at lower or higher priority . nice(l), nice(2) 

command, run immune to hangups, logouts, and quits . nohup(l) 

Command Set 80 Cartridge Tape Utility . tcio(l) 

command, set environment for . env(l) 

command substitution . sh(l) 

command summary: per-process accounting records . acctcms(lM) 

command, time the execution of . time(l) 

commands, execute at specified date(s) and time(s) . at(l), cron(lM) 

commands, install in file system . install (IM) 

commands, process accounting . acctcom(l) 

common lines, find after comparing two files . comm(l) 

common logarithm . exp(3M) 

communication, establish interactive communication with another UNIX/HP-UX system . cu(l) 

compact . compact (1) 

compare two directories . dircmp(l) 

compare two files . bdiff(l), cmp(l), diff(l) 

compare two strings . string(3C) 

compare two versions of SCCS file . sccsdiff(l) 

compile . regexp (7) 

compiled term file format . term(5) 

compiler, C . cc(l) 

compiler development . yacc(l) 

compiler, FORTRAN 77 . fc(l), f77(l) 

compiler, Pascal. pc(l) 

compiler: terminfo . tic(lM) 

compiler-compiler . yacc(l) 

complementary error function and error function . erf(3M) 

compress and uncompress files, and cat them . compact(1) 

compress and uncompress files, and cat them . compact(1) 

concatenate, copy, and/or print files . cat(l) 

concatenate lines in one or more files . paste(l) 

concatenate two strings . string(3C) 

conditional expressions, evaluate and test . sh(l), test(l) 
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Permuted Index 


config . config(lM) 

configure an HP-UX system . config(lM) 

configure LP spooler system . mklp(lM) 

connect to remote terminal . dial(3C) 

connect-time accounting. acctcon(lM) 

constants and functions, math . math(7) 

construct a Bell file system . bifmkfs(l) 

construct file system on special file . mkfs(lM) 

construct new file system . newfs(lM) 

contents of directory, list . ls(l) 

context-free grammar, create. yacc(l) 

continue . sh(l) 

control characters, interpret ASA carriage . asa(l) 

control device . ioctl(2), stty(2) 

control-flow constructs, shell programming language . sh(l) 

conventional terminal names . term (7) 

convert archives to new format . arcv(l) 

convert between 3-byte integers and long integers . 13tol(3C) 

convert between long and base-64 ASCII . a641(3C) 

convert binary wtrnp records into ASCII . fwtmp(lM) 

convert date and time to ASCII . ctime(3C) 

convert floating point value to ASCII string . ecvt(3C) 

convert, reblock, translate, and copy a (tape) file . dd(l) 

convert string to double-precision integer . strtod(3C) 

convert string to integer. strtol(3C) 

convert tape file . dd(l) 

convert termcap description to terminfo description ... captoinfo(lM) 

copy an open file descriptor . dup(2), fcntl(2) 

copy, concatenate, and/or print files . cat(l) 

copy files between two systems . uucp(l), uuto(l) 

copy files out to media . cpio(l) 

copy files while simultaneously editing them . sed(l) 

copy line from standard input to standard output . line(l) 

copy, link, or move files . cp(l) 

copy operating system from one or more SDF boot areas to another . oscp(lM) 

copy string. string(3C) 

copy tape file . dd(l) 

copy to or from BIF files . bifcp(l) 

copy to or from LIF files . lifcp(l) 

core image, examine and/or modify for child process . ptrace(2) 

core image file, description of. core(5) 

cos . trig(3M) 

cosh . sinh(3M) 

cosine function . trig(3M) 

cosine, hyperbolic . sinh(3M) 

cp . cp(l) 

cpio . cpio(l) 

cpio archive format, description of. cpio(5) 

cpio archives, unpack/extract from 5.25" flexible discs . upm(l) 

cpio archives, unpack/extract from Command Set 80 cartridge tape . upm(l) 

cpp . cpp(l) 

cpset . cpset(lM) 

CPU type . machid(l) 

creat . creat(2) 

create a directory . mkdir(l) 
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Permuted Index 


create a directory file . 

create a name for a temporary file . 

create a new process . 

create a special file entry . 

create an interprocess channel . 

create and open temporary file . 

create cat files for the manual . 

create delta (change) for SCCS file. 

create device files . 

create directory, block/character special, fifo, or ordinary file 

create encryption key . 

create libraries, archives. 

create link to file . 

create message catalog file for modification. 

create mnttab table. 

create new file, overwrite existing file . 

create new operating system from ordinary files . 

create or change parameters of SCCS files . 

create unique file name . 

creation mask, get/set for file . 

cron. 

crontab. 

CRT, facilitate viewing of continuous text on . 

CRT, information about graphics devices with . 

CRT screen handling and optimization routines . 

crypt . 

C-source error messages into a file . 

ct .. 

ctermid. 

ctime .. 

cu . 

current directory, print name of . 

current events, print . 

current user id . 

current user in utmp file, find . 

current working directory, change . 

current working directory pathname . 

current working directory, print name of. 

curses . 

cursor handling and optimization routines . 

cuserid. 

cut . 

cut out selected fields of each line of a file . 

daily accounting . 

data access, long integer, machine independent . 

data base, relational data base operator. 

Data Encryption Standard . 

data segment, change space allocation for. 

data segments, specify maximum number of. 

data types, include file defining data types for system code .. 

database access. 

datacomm, accept/reject files received through uucp or uuto 

datacomm, copy files between two systems. 

datacomm, execute command on another system . 

datacomm, list of known system names . 


. mkdir(2) 

. tmpnam(3S) 

. fork(2) 

. mknod(5) 

. pipe(2) 

. tmpfile(3S) 

. catman(lM) 

. delta(l) 

. mkdev(lM) 

. mknod(2), mknod(lM) 

. makekey(lM) 

. ar(l) 

. link(lM), link(2) 

. findmsg(l) 

. setmnt(lM) 

. creat(2) 

. oscp(lM) 

. admin(l) 

. mktemp(3C) 

sh(l), umask(l), umask(2) 

. cron(lM) 

. crontab(l) 

. more(l) 

. graphics (4) 

. curses (3X) 

. crypt (3C) 

. mkstr(l) 

. ct(4) 

. ctermid(3S) 

. ctime(3C) 

. cu(l) 

. pwd(l) 

. news(l) 

. whoami(l) 

.. ttyslot(3C) 

. cd(l), sh(l), chdir(2) 

. getcwd(3C) 

. pwd(l) 

. curses(3X) 

. curses (3X) 

. cuserid(3S) 

. cut(l) 

. cut(l) 

. runacct(lM) 

. sputl(3X) 

. join(l) 

. crypt (3C) 

. brk(2) 

. uconfig(lM) 

. types(7) 

. query (1) 

. uuto(l) 

. uucp(l), uuto(l) 

. uux(l) 

. uucp(l) 
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Permuted Index 


datacomm, log of uucp and uux transactions . 

date . 

date and time, convert to ASCII string. 

date and time, get more precisely . 

date, get/set. 

date, set . 

date, set and/or print . 

dates, reminder service for important . 

daylight . 

daylight saving time, time corrected for. 

dd . 

deallocate a block of memory . 

debug damaged file system . 

debugger. 

debugging, enable break-point debugging for child process. 

decompiler: terminfo . 

delays, settings and controls for terminal output . 

delta . 

delta, add to SCCS file . 

delta, change commentary of SCCS . 

delta, inform user of any deltas being created for specific SCCS file 

delta, remove from SCCS file . 

demand loadable, set for program . 

deroff. 

DES password encryption . 

description of environment . 

description of /etc/passwd, pwd.h files . 

description of group file . 

description of magic.h and magic numbers. 

description of OS management commands . 

descriptor, close file . 

descriptor, copy/duplicate file . 

descriptor, get value of file . 

device, description of hpib interface to . 

device driver, select virtual device driver . 

device drivers, list . 

device file, create block/character . 

device files, create . 

device files, perform functions on . 

device names, pack/unpack for mknod(2) . 

device I/O library . 

devices, backing store. 

devices, information about those with graphics crt’s . 

devnm . 

df . 

diagnostics, add to program . 

dial . 

dial out to a remote terminal . 

dialup security control . 

diff . 

differences between files, mark . 

differential file comparison, 3-way . 

diffh . 

diffmk. 

digitizer, description of hpib interface to . 


. uucp(l) 

. date(l) 

. ctime(3C) 

. ftime(2) 

. gettimeofday(2) 

. stime(2) 

. date(l) 

. calendar(l) 

. ctime(3C) 

. ctime(3C) 

. dd(l) 

. malloc(3C) 

. fsdb(lM) 

. adb(l) 

. ptrace(2) 

. untie (IM) 

. tty(4) 

. delta(l) 

. delta(l) 

. cdc(l) 

. sact(l) 

. rmdel(l) 

. chatr(l) 

. deroff(l) 

. crypt (3C) 

. environ(7) 

. passwd(5) 

. group(5) 

. magic(5) 

. osmgr(lM) 

. close(2) 

. dup(2), fcntl(2) 

. ferror(3S) 

. hpib(4) 

. uconfig(lM) 

. Isdev(l) 

. mknod(2), mknod(lM) 

. mkdev(lM) 

. ioctl(2), stty(2) 

.. mknod(5) 

gpio_*(3I), hpib_*(3I), io_*(3I) 

. vson(2) 

. graphics (4) 

. devnm(lM) 

. df(lM) 

. assert (3X) 

. dial(3C) 

. dial(3C) 

. dialups(5) 

. diff(l) 

. diffmk(l) 

. diff3(l) 

. difr(l) 

. diffmk(l) 

.. hpib(4) 
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Permuted Index 


dircmp. dircinp(l) 

directory, change root for duration of command . chroot(l), chroot(2) 

directory, change working ... cd(l), sh(l), chdir(2) 

directory clean-up for uucp spool directory . uuclean(lM) 

directory, compare two . dircmp(l) 

directory, create . . . . . . . . . . . . .. mkdir(l), mknod(2) 

directory, description of internal SDF format of . dir(5) 

directory, extract from path name . basename(l) 

directory, list contents of. ls(l) 

directory, list contents of LIF . lifls(l) 

directory, move.:. mvdir(lM) 

directory, print name of current working. pwd(l) 

directory, remove . rm(l) 

directory, remove . rmdir(2) 

dirname . basename(l) 

disc blocks, report number of free . df(lM) 

disc description file . disktab(5) 

disc drivers, information about blocked/unblocked interface. disc(4) 

disc initialization . mediainit(l) 

disc storage, preallocate . prealloc (1) 

disc usage accounting by user ID . diskusg(lM) 

disc usage, summarize . du(l) 

disc, write current contents of memory to . sync(2), sync(l) 

diskusg . diskusg(lM) 

display buffering, specify number of pages of. uconfig(lM) 

documentation, on-line . man(l) 

documents, print using mm macros. mm(l) 

dot (.) command. sh(l) 

drand48 . drand48(3C) 

driver, information about blocked/unblocked disc interface . disc(4) 

drivers, list device . Isdev(l) 

du . du(l) 

dump, octal or hexadecimal. 0 ^( 1 ) 

dumpmsg . dumpmsg (1) 

dup . dup(2) 

dup2 . dup2(2) 

duplicate an open file descriptor . dup(2), fcntl(2) 

duplicate open file descriptor . dup2(2) 

e . 6x(l) 

echo. echo(l) 

echo (print) arguments after shell interpretation . echo(l) 

ecvt . ecvt(3C) 

ed . ed(l) 

edata. end(3C) 

edit . ex(l) 

editing activity, print for SCCS file . sact(l) 

editor, stream text . sed(l) 

editor, text . ed(l), ex(l) 

editor, visual text . vi(l) 

effective current user id. whoami(l) 

effective user/group ID’s, get for process . getuid(2) 

egrep . grep(l) 

EMS . ems(2) 

EMS, description of. ems(2) 

emulation of asynchronous terminal . aterm(l) 
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Permuted Index 


enable swapping and paging . swapon(lM) 

encrypt passwords . crypt(3C) 

encryption key, generate . makekey(lM) 

end . end(3C) 

endgrent . gctgrent(3C) 

endpwent . getpwent(3C) 

env . env(l) 

environment, description of parameters and usage . sh(l), environ(7) 

environment, install parameters in . sh(l) 

environment, print current . env(l) 

environment, set for duration of one command . env(l) 

environment, set up at login time. profile(5) 

environment variable, get value of . getenv(3C) 

EOF (end-of-file) character, description of . tty(4) 

EOF, indicate receipt of when reading file. ferror(3S) 

EOL (end-of-line) character, description of . tty(4) 

eqn, tbl, nroff, troff constructs, remove from text . deroff(l) 

erase character, description of . tty(4) 

erf . erf(3M) 

erfc . erf(3M) 

err . err(l) 

errfile . errfile(5) 

errinfo . errinfo(2) 

errinfo, report value for last command failure. err(l) 

errno . errno(2) 

errno, report value for last command failure. err(l) 

ERROR . regexp(7) 

error function and complementary error function . erf(3M) 

error handling, mathematical . matherr(3M) 

error indicator. errinfo(2) 

error indicator for system calls. errno(2) 

error indicator, reset status of . ferror(3S) 

error indicator while reading file . ferror(3S) 

error information on last command failure . err(l) 

error logging file for system . errfile(5) 

error message generator from C programs . perror(3C) 

etext . end(3C) 

eval . sh(l) 

evaluate arguments as an expression . expr(l) 

ex . ex(l) 

examine text, facilitate on soft-copy terminals . more(l) 

exec . sh(l), exec(2) 

execl . exec(2) 

execle. exec (2) 

execlp . exec(2) 

executable file, extract symbol table (name list) entries from . nlist(3C) 

executable file, get size of . size(l) 

executable linker/assembler output file, description of. a.out(5) 

execute a file in current process . exec(2) 

execute command at lower or higher priority . nice(l), nice(2) 

execute command immune to hangups, logouts, and quits . nohup(l) 

execute command on another system . uux(l) 

execute command using different root directory . chroot(l) 

execute commands at specified date(s) and time(s) . at(l), cron(lM) 

execute commands from file . sh(l) 
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Permuted Index 


execute new program in existing process . sh(l), exec(2) 

execute process with real-time priority . rtprio(l) 

execute HALGOL programs . opx25(lM) 

execute uucp commands on local system . uuxqt(lM) 

execute work requests on remote system . uucico(lM), uux(l) 

execution profile, create for program . profil(2), monitor(3C) 

execution, suspend process execution for time interval . sleep(l), sleep(3C) 

execv . exec(2) 

execve . exec(2) 

execvp . exec(2) 

—exit . exit(2) 

exit. sh(l), exit(2) 

exit from enclosing for or while loop . sh(l) 

exp . exp(3M) 

expand . expand(l) 

expand tabs to spaces, and vice versa . expand(l) 

exponent, raise 2 to a power . frexp(3C) 

exponential function . exp(3M) 

export . sh(l) 

expr. expr(l) 

expreserve . 6x(l) 

expression, evaluate arguments as . expr(l) 

exrecover . ^^(f) 

Extended Memory System description . ems(2) 

external symbols, examine execution profile for . prof(l) 

extract entries from symbol table (name list) of executable file . nlist(3C) 

extract error messages from C source into a file. mkstr(l) 

extract files from 5.25" flexible discs . upm(l) 

extract files from Command Set 80 cartridge tape archives . upm(l) 

extract files from media . cpio(l) 

extract portions of path names . basename(l) 

f77 . fc(l) 

f77 . see fc(l) 

fabs . floor(3M) 

false . true(l) 

fc . fc(l) 

fclose. fclose(3S) 

fcntl . fcntl(2) 

fcntl(2), description of requests and arguments for . fcntl(7) 

fcntl.h, description of . fcntl(7) 

fcvt . ecvt(3C) 

fdopen. fopen(3S) 

feof . ferror(3S) 

ferror . ferror(3S) 

fflush... fclose (3S) 

fgetc. getc(3S) 

fgets . gets(3S) 

fgrep . grep(l) 

fifo special file, create . mknod(2), mknod(lM) 

file, assign another file name to already open file . fopen(3S) 

file, assign buffering to open . setbuf(3S) 

file attributes file, description of . fs(5) 

file, buffered read from . fread(3S) 

file, buffered write to . fread(3S) 

file, change group ID of . chown(l), chown(2) 
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Permuted Index 


file, change mode of . 

file, change owner . 

file, change permission bits . 

file, check revision number for . 

file, close a buffered open file . 

file comparison, three-way differential . 

file control . 

file control constants, file containing definitions of. 

file, copy LIF in or out . 

file, copy to tape while performing certain conversions . 

file, count words, lines, and characters contained therein . 

file, create and open temporary . 

file, create device/special . 

file, create or overwrite ordinary . 

file, create or remove link to/from . 

file, create ordinary . 

file creation mask, set . 

file, description of buffered I/O . 

file, description of password file, /etc/passwd . 

file, description of SCCS file format . 

file descriptor, assign stream to . 

file descriptor, close . 

file descriptor, copy/duplicate . 

file descriptor, create file pointer using . 

file descriptor, determine if associated with terminal . 

file descriptor, get value of . 

file, determine accessibility of . 

file, error logging file for system . 

file, find and/or remove duplicate lines in . 

file, find spelling errors in . 

file format, per-process accounting. 

file, generate name for temporary . 

file, get information about . 

file, get/set status flags for . 

file, indicate the occurrence of an error while reading. 

file, indicate when EOF is encountered when reading from . 

file, locate in file system . 

file, move to new position in . 

file name, create file name vs. i-node list . 

file name, create unique . 

file name, extract from path name .. 

file name, find special file for mounted file system on which file lies 

file name, generate for temporary file . 

file name, generate for terminal . 

file, open for reading or writing . 

file, open with assigned buffering . 

file owner or group, change . 

file pointer, create using file descriptor . 

file pointer, move read/write (seek) . 

file pointer, obtain for file . 

file pointer, re-assign to another file. 

file, print last part of .. 

file, put line length specifications in text files . 

file, put margin specifications in text files. 

file, put tab specifications in text files . 


. chmod(l), chmod(2) 

. chown(l), chown(2) 

. chmod(l), chmod(2) 

. revck(lM) 

. fclose(3S) 

. diff3(l) 

. fcntl(2) 

. fcntl(7) 

. lifcp(l) 

. dd(l) 

. wc(l) 

.. tmpfile(3S) 

. mkdev(lM) 

. creat(2) 

link(lM), link(2), unlink(2) 

.. mknod(2) 

sh(l), umask(l), umask(2) 

. stdio(3S) 

. passwd(5) 

. sccsfile(5) 

. fopen(3S) 

. close(2) 

. dup(2), fcntl(2) 

. fopen(3S) 

. tty name (3 C) 

. ferror(3S) 

. access(2) 

. err file(5) 

. uniq(l) 

. spell(l) 

. acct(5) 

. tmpnam(3S) 

. stat(2) 

. fcntl(2) 

. ferror(3S) 

. ferror(3S) 

. find(l) 

. lseek(2) 

. ncheck(lM) 

. mktemp(3C) 

. basename(l) 

. devnm(lM) 

. tmpnam(3S) 

. ctermid(3S) 

. open(2) 

. fopen(3S) 

. bifchown(l) 

. fopen(3S) 

. lseek(2) 

. fopen(3S) 

. fopen(3S) 

. tail(l) 

. fspec(5) 

. fspec(5) 

. fspec(5) 
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Permuted Index 


file, read and execute commands from . 

file, read and format data from . 

file, read character from. 

file, read from . 

file, read string from . 

file, read word from ... 

file, remove . 

file, remove a LIF . 

file, remove extra new-line characters from. 

file, remove selected fields from each line in . 

file, remove selected table column entries from . 

file, rename LIF . 

file, rewind before next I/O operation . 

file scanner, big. 

file, search contents of for specified string(s) . 

file, set/clear set-user-ID, set-group-ID, sticky bits . 

file size limit, get for process . 

file, sort contents of . 

file, split into pieces. 

file system, backup file system on cpio archive . 

file system (Bell) consistency check and interactive repair 

file system (Bell) debugger . 

file system consistency check and interactive repair. 

file system, construct on special file . 

file system debugger . 

file system descriptor file entry. 

file system, find special file associated with . 

file system hierarchy . 

file system, install commands in .. 

file system, list of those to be checked by fsck(lM) . 

file system, mount or unmount . 

file system name, get for mounted. 

file system pack name, get for mounted . 

file system shutdown status . 

file system, table of mounted file systems . 

file, system’s "bit bucket" special file . 

file transfer: XMODEM protocol . 

file transfers: KERMIT-protocol . 

file tree walk. 

file, update access/modification/change times of. 

file utilities. Bell Interchange Format . 

file, write character onto . 

file, write formatted data onto . 

file, write LIF volume header on . 

file, write string onto . 

file, write to . 

file, write word onto . 

file-creation mode mask, get/set . 

fileno . 

files, archive on tape . 

files, check password and group files . 

files, compare two . 

files, compare two and create change bars . 

files, compare two and find lines common to both . 

files, compare two and find lines unique to each . 


. sh(l) 

. scanf(3S) 

. getc(3S) 

. read(2) 

. gets(3S) 

. getc(3S) 

.r rm(lj 

. lifrm(l) 

. rmnl(l) 

. cut(l) 

. cut(l) 

. lifrename(l) 

. fseek(3S) 

. bfs(l) 

. grep(l) 

. chmod(l), chmod(2) 

. ulimit(2) 

. sort(l) 

. split(l) 

. backup(lM) 

. biffsck(l) 

. biffsdb(l) 

. fsck(lM) 

. mkfs(lM) 

. fsdb(lM) 

. getfsent(3X) 

. devnm(lM) 

. hier(7) 

. install(IM) 

. checklist(5) 

mount (IM), mount(2), umount(2) 

. ustat(2) 

. ustat(2) 

. fsclean(lM) 

. mnttab(5) 

. null(4) 

. umodem(lM) 

. kermit(lM) 

. ftw(3C) 

. touch(l), utime(2) 

. bif(5) 

. putc(3S) 

. printf(3S) 

. lifinit(l) 

. puts(3S) 

. write(2) 

. putc(3S) 

. umask(l), umask(2) 

. ferror(3S) 

. tar(l) 

. pwck(lM) 

. bdifF(l), cmp(l), diff(l) 

. diffmk(l) 

. comm(l) 

. comm(l) 
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Permuted Index 


files, concatenate two or more . cat(l) 

files, copy . cat(l) 

files, copy and simultaneously edit . sed(l) 

files, copy between two systems . uucp(l), uuto(l) 

files, copy out to media. cpio(l) 

files, description of /etc/profile and $HOME/.profile . profile(5) 

files, extract from media . cpio(l) 

files, format and print . pi’ll) 

files, merge lines in one or more . paste(l) 

files, move, link, or copy . cp(l) 

files, print . cat(l) 

files, unpack/extract from 5.25" flexible discs . upm(l) 

files, unpack/extract from Command Set 80 cartridge tape archives. upm(l) 

filter reverse line-feeds and backspaces . col(l) 

find . find(l) 

find current user slot in utmp file . ttyslot(3C) 

find duplicate lines in file . uniq(l) 

find files . find(l) 

find files in a BIF system . biffind(l) 

find name of a terminal . ttyname(3C) 

find strings for inclusion in message catalog. findstr(l) 

findmsg . findmsg(l) 

findstr . findstr(l) 

fix manual pages for faster viewing with man(l) . fixman(l) 

fixman . fisman(l) 

flag, get/set close-on-exec. fcntl(2) 

flags, mapping pwb/V6 UNIX terminal flags into current HP-UX . tty(4) 

flags, set shell . sh(l) 

flexible discs, unpack/extract files from . upm(l) 

floating point number, split into integer and fractional parts . frexp(3C) 

floating point to ASCII conversion . ecvt(3C) 

floor . floor (3M) 

flow graph, C, generate . cflow(l) 

flush buffers associated with an open file . fclose(3S) 

fmod . floor(3M) 

fold long lines for finite-width output device . fold(l) 

fopen. fopen(3S) 

for loop, exit from enclosing . sh(l) 

for loop, resume the next iteration of . sh(l) 

fork . fork(2) 

format and print files . pi’ll) 

format C program . cli(l) 

format, compiled term file. term(5) 

format data into string. printf(3S) 

format data on buffered open file . printf(3S) 

format data on standard output . printf(3S) 

format, nlist structure . nlist(5) 

format of an i-node, description of . inode(5) 

format of a.out file, description of . a.out(5) 

format of core image file, description of . core(5) 

format of cpio archive, description of. cpio(5) 

format of library/archive file, description of . ar(5) 

format of SCCS file, description of . sccsfile(5) 

format, privileged values. privgrp(5) 

format SDF volume. sdfinit(lM) 
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Permuted Index 


format specifications, put in text file . fspec(5) 

format tables for nroff or troff . tbl(l) 

format text . nroff(1) 

formatted output from varargs argument list . vprintf(3S) 

formatted output with numbered arguments . printmsg(3C) 

formatter, text, simple. adjust(l) 

formatting text with the man macros. man (7) 

formatting text with the mm macros . mm (7) 

FORTRAN 77 compiler . fc(l), f77(l) 

fprintf. printf(3S) 

fputc . putc(3S) 

fputs . puts(3S) 

fread. fread(3S) 

free . malloc(3C) 

free blocks, find for mounted file system . ustat(2) 

free disc blocks, report number of . bifdf(l) 

free disc blocks, report number of. df(lM) 

free i-nodes, find for mounted file system . ustat(2) 

free memory space . memallc(2) 

freopen. fopen(3S) 

frexp . frexp(3C) 

fscanf. scanf(3S) 

fsck . fsck(lM) 

fsck . fsck(lM) 

fsck(lM), list of file systems to be checked by . checklist(5) 

fsclean . fsclean(lM) 

fsdb . fsdb(lM) 

fseek . fseek(3S) 

fstat . stat(2) 

fstat(2)/stat(2), description of structure returned by these calls . stat(7) 

ftell . fseek(3S) 

ftime . ftime(2) 

ftw. ftw(3C) 

functions and constants, math . math(7) 

fwrite. fread(3S) 

fwtmp . fwtmp(lM) 

gamma. gamma(3M) 

gcvt . ecvt(3C) 

gencat . gencat(l) 

general terminal interface. termio(4) 

generate a formatted message-catalog file . gencat (1) 

generate C flow graph . cflow(l) 

generate encryption key . makekey(lM) 

generate uniformly-distributed pseudo-random numbers . drand48(3C) 

get . get(l) 

get date and time more precisely . ftime(2) 

get entries from symbol table (name list) of executable file . nlist(3C) 

get file system descriptor file entry. getfsent(3X) 

get group access list . get groups (2) 

get message from a catalog . getmsg(3C) 

get message queue . msgget(2) 

get name of current host . gethostname(2) 

get password file entry . getpwent(3C) 

get pathname of current working directory. getcwd(3C) 

get real/effective user, real/effective group IDs . getuid(2) 


- 16 - 


























































Permuted Index 


get set of semaphores . semget(2) 

get shared memory segment . shmget(2) 

get special attributes for group . getprivgrp(l) 

get X.25 line . getx25(lM) 

getc . getc(3S) 

GETC . regexp(7) 

getchar. getc(3S) 

getcwd . getcwd(3C) 

getegid. getuid(2) 

getenv . getenv(3C) 

geteuid . getuid(2) 

getfsent . getfsent(3X) 

getgid . getuid(2) 

getgrent . getgrent(3C) 

getgrgid . getgrent(3C) 

getgrnam . getgrent (3C) 

getgroups . getgroups(2) 

gethostname . gethostname(2) 

getitimer . getitimer(2) 

getlogin . getlogin(3C) 

getmsg . getmsg(3C) 

getmsg, insert calls using findstring output . insertmsg(l) 

getopt . getopt(l) 

getopt . getopt(3C) 

getpass . getpass(3C) 

getpgrp . getpid(2) 

getpid . getpid(2) 

getppid . getpid(2) 

getprivgrp. getprivgrp(l), getprivgrp(2), setprivgrp(lM), privgrp(5) 

getpw . getpw(3C) 

getpwent . getpwent(3C) 

getpwnam. getpwent (3C) 

getpwuid . getpwent (3C) 

gets . gets(3S) 

get/set date and time. gettimeofday(2) 

get/set special attributes for group . getprivgrp(2) 

get/set value of interval timer. getitimer(2) 

gettimeofday . gettimeofday(2) 

getty . getty(lM) 

getuid . getuid(2) 

getut . getut(3C) 

getw . getc(3S) 

getx25 . getx25(lM) 

gmtime. ctime(3C) 

goto, non-local. setjmp(3C) 

grammar, create context-free. yacc(l) 

graphics devices, information for those with crt’s. graphics(4) 

grep . grep(l) 

group . group(5) 

group access list, set . setgroups(2) 

group, change ID of user. newgrp(l) 

group file, close . getgrent(3C) 

group file, description of /etc/group. group(5) 

group file, read one line from . getgrent(3C) 

group file, rewind . getgrent(3C) 
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Permuted Index 


group file, search for matching group ID . getgrent(3C) 

group file, search for matching group name . getgrent(3C) 

group ID, change for file . chown(l), chown(2) 

group ID, change for user . newgrp(l), sh(l) 

group ID, get for process . getpid(2) 

group ID, print . id(l) 

group ID, search group file for matching . getgrent(3C) 

group ID, set . setuid(2) 

group ID, set for process . setpgrp(2) 

group memberships, show . groups(l) 

group name, search group file for matching . getgrent(3C) 

group/password file checkers . pwck(lM) 

groups . groups (1) 

group special attributes, get . getprivgrp(l) 

group special attributes, set . setprivgrp(lM) 

grpck . pwck(lM) 

grp.h . group(5) 

gsignal . ssignal(3C) 

gtty . stty(2) 

handling facility, variable argument list . varargs(7) 

hangups, run command immune to . nohup(l) 

hardware name, get . uname(l), uname(2) 

hardware trap numbers, list of . trapno(2) 

hash search tables . hsearch(3C) 

header, write LIF volume on file . lifinit(l) 

heap size, change for program . chatr(l) 

help . help(l) 

help, get for SCCS routines . help(l) 

hexadecimal, octal dump . od(l) 

hier . hier(7) 

hierarchy, file system . hier(7) 

host name, get . gethostname(2) 

host name, set . sethostname(2) 

host system, set/print name of current . hostname (1) 

hostname . hostname(l) 

hpib interface, description of . hpib(4) 

hpnls . hpnls(7) 

HP-UX implementations, conditional compilation depending on . model(5) 

HP-UX implementations, definition of constants which identify . model(5) 

HP-UX machine identification . model(5) 

HP-UX revision information, get. revision(l) 

HP-UX version name, get . uname(l), uname(2) 

hsearch . hsearch(3C) 

hyperbolic functions . sinh(3M) 

hypot . hypot(3M) 

hypotenuse, function for calculating . hypot(3M) 

id . id(l) 

ID’s, set user and group. setuid(2) 

init . init(lM) 

INIT . regexp (7) 

init(lM), control information for . inittab(5) 

initgroups . init groups (3C) 

initialization of system state and processes. init(lM) 

initialize group access list. initgroups(3C) 

initialize hard disc, flexible disc, or cartridge tape media . mediainit(l) 
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Permuted Index 


initialize SDF volume . sdfinit(lM) 

initialize terminal type and mode on login . tset(l) 

inittab . inittab(5) 

i-node, clear i-node by zeroing it out . clri(lM) 

i-node, description of i-node format . inode(5) 

i-node, enable access to i-node for file system repair. fsdb(lM) 

i-nodes, create file name vs. i-node list . ncheck(lM) 

i-nodes, find number of free i-nodes in mounted file system . ustat(2) 

input and format data from buffered open file . scanf(3S) 

input and format data from standard input . scanf(3S) 

input and format data from string . scanf(3S) 

input commands to shell . sh(l) 

input control, description of input control for terminal . tty (4) 

input/output between process and command . popen(3S) 

input/output, description of buffered file . stdio(3S) 

input/output operation, get current byte offset of. fseek(3S) 

input/output operation, reposition next . fseek(3S) 

input/output, output character/word to open file or standard output . putc(3S) 

input/output, push character back into input stream . ungetc(3S) 

input/output redirection . sh(l) 

input/output, write string to open file or standard output . puts(3S) 

insert calls to getmsg using findstring output . insertmsg(l) 

install . install(lM) 

install commands into file system . install(lM) 

install object files in binary directories. cpset(lM) 

integer, get largest integer smaller than x . floor(3M) 

integer, get smallest integer larger than x . floor(3M) 

integers, convert between 3-byte and long . 13tol(3C) 

integer trap control . intrapoff(3M) 

integrity check of operating system in SDF boot area(s) . osck(lM) 

interactive IMAGE database access. query (1) 

interactively write (talk) to another user . write(1) 

interface, description of hpib . hpib(4) 

interface to blocked/unblocked disc, description of . disc(4) 

interface to terminal I/O, description of. tty(4) 

interleave factor, establish for SDF volume . sdfinit(lM) 

interprocess communication, create . pipe(2) 

inter-process communication facilities status . ipcs(l) 

inter-process communication routines . stdipc(3C) 

interrupt character, description of. tty(4) 

intrapoff . intrapoff(3M) 

I/O between process and command . popen(3S) 

I/O, description of buffered file . stdio(3S) 

I/O operation, get current byte offset of. fseek(3S) 

I/O operation, reposition next . fseek(3S) 

I/O, output character/word to open file or standard output. putc(3S) 

I/O, push character back into input stream . ungetc(3S) 

I/O redirection . sti(l) 

I/O: GPIO routines (device I/O library) . gpio_*(3I) 

I/O: HP-IB routines (device I/O library) . hpib_*(3I) 

I/O: I/O routines (device I/O library) . io_*(3I) 

I/O, write string to open file or standard output . puts(3S) 

ioctl . ioctl(2) 

ioctl(2) system calls, description of. tty(4:) 

iomap . iomap(4) 
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Permuted Index 


ipcrm. ipcrm(l) 

ipcs . ipcs(l) 

isalnum . ctype(3C) 

isalpha. ctype(3C) 

isascii . ctype(3C) 

isatty . ttyname(3C) 

iscntrl. ctype(3C) 

isdigit . ctype(3C) 

isgraph . ctype(3C) 

islower. ctype(3C) 

isprint . ctype(3C) 

ispunct . ctype(3C) 

isspace. ctype(3C) 

issue identification file . issue(5) 

isupper . ctype(3C) 

isxdigit . ctype(3C) 

jO . bessel(3M) 

jl . bessel(3M) 

jn . bessel(3M) 

join . join(l) 

join, perform join of two data base relations . join(l) 

kanaS . kana8(7) 

kermit . kermit(lM) 

key, generate encryption . makekey(lM) 

kill. kill(l) 

kill character, description of . tty(4) 

killall . killall(lM) 

1 . Ml) 

13tol . 13tol(3C) 

164a . a641(3C) 

langid . langid(7) 

langinfo . langinfo(3C) 

language identification variable . langid(7) 

language information . langinfo(3C) 

last-accessed time, update for file. touch(l), utime(2) 

last-changed time, update for file . touch(l) 

last-modified time, update for file . touch(l), utime(2) 

Id . ld(l) 

Idexp . frexp(3C) 

leave . leave (1) 

length of string, get . string(3C) 

lex . lex(l) 

lexical analysis of text, generate programs for . lex(l) 

libraries and archives, create and maintain . 

library file format, description of . ar(5) 

library file format, description of cpio archive format . cpio(5) 

library, find ordering relation for object . lorder(l) 

library, table of contents format description . ranlib(5) 

LIF directory, list contents of . lifis(l) 

LIF file, remove . lifrm(l) 

LIF file, rename . lifrename(l) 

LIF files, copy in or out . lifcp(l) 

LIF volume header, write on file . lifinit(l) 

lifcp . lifcp(l) 

lifinit . lifinit(l) 
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Permuted Index 


lifts . lifts (1) 

lifrename . lifrename(l) 

lifrm. lifrm(l) 

line . line(l) 

line, copy from standard input to standard output . line(l) 

line count . wc(l) 

line length, put line length specifications in text files . fspec(5) 

linear search and update . lsearch(3C) 

lines, count number contained in file . wc(l) 

lines, find common lines in two files . comm(l) 

lines, find unique lines in two files . comm(l) 

lines, merge in one or more files . paste(l) 

link . link(lM), link(2) 

link, copy, or move files . cp(l) 

link, create to or remove from file . link(lM), link(2), unlink(2) 

link editor . ld(l) 

link information utility, object files . linkinfo(l) 

linker. ld(l) 

linker/assembler executable output file, description of. a.out(5) 

linkinfo . linkinfo(l) 

lint . lint(l) 

list active processes in system . ps(l) 

list contents of BIF directories. bifis(l) 

list contents of directories . ls(l) 

list contents of LIF directory . lifis(l) 

list current users on system . who(l) 

list device drivers . Isdev(l) 

list file names with associated i-nodes . ncheck(lM) 

list spooled uucp transactions grouped by transaction . uuls(l) 

list users and their current processes . whodo(lM) 

11 . ls(l) 

In . cp(l) 

localtime . ctime(3C) 

locate files in file system . find(l) 

locate source, binary, and/or manual for program . whereis(l) 

lock . lock(l) 

lock process, text, or data in memory . plock(2) 

lock terminal . lock(l) 

lockf. lockf(2) 

lock/unlock process address space or segment . memlck(2) 

log . exp(3M) 

log gamma function . gamma(3M) 

log results of work requests on remote system . uucico(lM) 

loglO. exp(3M) 

logarithm, common. exp(3M) 

logarithm, natural . exp(3M) 

logging file for system errors . errfile(5) 

logging in on HP-UX . login(l) 

logical block, set number of bytes per logical block . sdfinit(lM) 

Logical Interchange Format description . lif(5) 

login . login(l) 

login, establish baud rate and communication with terminal during. getty(lM) 

login name, get . logname(l), getlogin(3C) 

login name, get ASCII string representing . cuserid(3S) 

login name, print . id(l) 
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Permuted Index 


login name, record for each user (accounting) . utmp(5) 

login shell, change default . chsh(l) 

login time, record for each user (accounting) . utmp(5) 

logname . logname(l) 

logouts, run command immune to . nohup(l) 

long integer, convert to base-64 ASCII. a641(3C) 

long integer data access, machine independent . sputl(3X) 

long integers, convert to/from 3-byte integers . 13tol(3C) 

longjmp . setjmp(3C) 

lorder . lorder(l) 

lower-case to upper-case character conversion . conv(3C) 

Is. ls(l) 

Isdev. Isdev(l) 

Isearch . lsearch(3C) 

Iseek. lseek(2) 

Isf . ls(l) 

Isr . ls(l) 

Isx. ls(l) 

ltol3 . 13tol(3C) 

m4 . m4(l) 

machid . machid(l) 

machine ID, get . uname(l), uname(2) 

machine processor type . machid(l) 

machine-dependent values . values (7) 

macro processor . m4(l) 

macros for formatting entries in the HP-UX Reference manual. man (7) 

macros for formatting text . mm (7) 

magic numbers, description of. magic(5) 

magic.h, description of . magic(5) 

magnetic tape, description of raw interface and controls . mt(4) 

magnetic tape, manipulate and/or position . mt(l) 

mail . mail(l) 

mail, read or send to other users . mail(l) 

maintain libraries, archives . ar(l) 

maintain, update, recompile programs . make(l) 

make . make(l) 

make a BIF directory . bifmkdir(l) 

make file system on special file . mkfs(lM) 

make posters in large letters . banner(1) 

make unprintable characters in a file visible or invisible . vis(l) 

makekey . makekey(lM) 

malloc . malloc(3C) 

man . man(l) 

man macros, description of. man(7) 

manage binary search trees . tsearch(3C) 

manage hash search tables . hsearch(3C) 

manipulate wtmp records . fwtmp(lM) 

mantissa, get from floating point value. frexp(3C) 

manual, create preformatted manual pages for on-line . catman(lM) 

manual, on-line. man(l) 

manual page (on-line), locate for program . whereis(l) 

map characters into other characters during copy to standard output . tr(l) 

mapping, physical address . iomap(4) 

margins, put margin specifications in text files . fspec(5) 

mark Command Set 80 cartridge tape . tcio(l) 
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mark SDF operating system file as loadable/non-loadable . osmark(lM) 

mark/unmark volume as HP-UX root volume . rootmark(lM) 

mask, get/set file-creation . sh(l), umask(l), umask(2) 

master device information table . master(5) 

math . math (7) 

math functions and constants . math(7) 

mathematical error handling . matherr(3M) 

matherr . matherr(3M) 

MC68000 assembler . as(l) 

mediainit . mediainit(l) 

memadvise . memadvise(2) 

memallc . memallc(2) 

memberships, show group . groups(l) 

memchmd . memchmd(2) 

memfree . memallc(2) 

memlck. memlck(2) 

memory . memory(3C) 

memory, allocate a block of . malloc(3C) 

memory, allocate for array . malloc(3C) 

memory, change size of previously-allocated block . malloc(3C) 

memory, deallocate block of . malloc(3C) 

memory management, inform operating system about segment reference patterns . memadvise(2) 

memory management, modify segment length . memvary(2) 

memory operations. memory(3C) 

memory segment access modes, change . memchmd(2) 

memory space, allocate and free . memallc(2) 

memory, write to disc . sync(2), sync(l) 

memulck. memlck (2) 

memvary. memvary(2) 

merge contents of several files . sort(l) 

merge lines in one or more files . paste(l) 

merge or add total accounting files . acctmerg(lM) 

mesg . mesg(l) 

message catalogs: MPE/RTE . catread(3C) 

message control operations . msgctl(2) 

message operations . msgop(2) 

messages, permit/deny to your terminal . mesg(l) 

messages, read or send to other users . mail(l) 

messages, send to all users . wall(lM) 

messages, send to another user interactively . write(l) 

mkdev. mkdev(lM) 

mkdir . mkdir(l) 

mkdir . mkdir(2) 

mkfs . mkfs(lM) 

mklp . mklp(lM) 

mknod . mknod(2), mknod(lM) 

mknod.h, description of . mknod(5) 

mkstr . mkstr(l) 

mktemp . mktemp(3C) 

mm . mm(l) 

mm macros, description of . mm(7) 

mm macros, print documents formatted with . mm(l) 

mnttab table, create . setmnt(lM) 

mnttab.h, description of . mnttab(5) 

mod function, floating point. floor(3M) 
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Permuted Index 


mode, change for file . 

model, Native Language Support . 

model.h, description of. 

modem . 

modem control special file . 

modf . 

modify parameters of SCCS files . 

modify segment length. 

monitor . 

monitor uucp network . 

more . 

mount . 

mount or unmount file system . 

mounted devices, create table of . 

mounted devices, table of those mounted by mount(lM) . 

mounted file system, find special file associated with. 

mounted file system statistics . 

move a directory . 

move, link, or copy files . 

move read/write file pointer; seek . 

move to new working directory . 

msgctl . 

msgget . 

msgop. 

mt . 

multiple line-feeds, remove from output . 

mv . 

mvdir. 

name, get login . 

name list (symbol table), extract entries from executable file’s name list 

name list (symbol table), print from object file . 

Native Language Support model . 

natural logarithm . 

ncheck . 

network, monitor uucp activity on . 

network special file, create . 

new file system .. 

newfs . 

newfs . 

newgrp . 

new-line character, description of . 

new-line characters, remove extras from file . 

news . 

news, print current events . 

nice . 

nlist . 

nlist structure format . 

NLS character classification . 

NLS character set collating sequence tables . 

NLS character sets . 

NLS model . 

NLS native language information . 

NLS non-ASCII string collation . 

NLS translate characters . 

nl_string . 


. chmod(l), chmod(2) 

. hpnls(7) 

. model(5) 

. modem (4) 

. modem(4) 

. frexp(3C) 

. admin(l) 

. memvary(2) 

. monitQr(3C) 

. uusub(lM) 

. more(l) 

. mount(lM), mount(2) 

mount(IM), mount(2), umount(2) 

.. setmnt(lM) 

. mnttab(5) 

. devnm(lM) 

. ustat(2) 

. mvdir (IM) 

. cp(l) 

. lseek(2) 

. cd(l), sh(l), chdir(2) 

. msgctl(2) 

. msgget (2) 

. msgop(2) 

.. mt(l) 

. ssp(l) 

. cp(l) 

.. mvdir (IM) 

. logname(l), getlogin(3C) 

. nlist(3C) 

. nm(l) 

. hpnls(7) 

. exp(3M) 

. ncheck(lM) 

. uusub(lM) 

. mknod(2), mknod(lM) 

. newfs ( IM) 

. newfs (IM) 

. newfs (IM) 

. newgrp(l), sh(l) 

. tty(4) 

. rmnl(l) 

. news(l) 

. news(l) 

. nice(l), nice(2) 

. nlist(3C) 

. nlist(5) 

. nl_ctype(3C) 

. col__seq_8, col_seq_16 

. ascii(7), kana8(7), roman8(7) 

. hpnls(7) 

. langinfo(3C) 

. nl_string(3C) 

. nl_conv(3C) 

. nl_string(3C) 
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Permuted Index 


nm . 

nodename, get . 

nodename, set/print name of current . 

nohup . 

non-ASCII string collation used by NLS . 

nroff. 

nroff, format tables for. 

nroff, interpret output from nroff for printing . 

nroff, troff, tbl, eqn constructs, remove from text . 

numbered-argument print output formatting . 

object code, locate for program. 

object file, debugger for . 

object file, extract symbol table (name list) entries from . 

object file, get size of . 

object file link information utility . 

object file, print symbol table (name list) of . 

object file, remove symbol table and relocation bits from . 

object files, combine into program . 

object library, find ordering relation for . 

octal, hexadecimal dump . 

od . 

on-line manual command . 

on-line manual, create preformatted manual pages for . 

open . 

open a file and assign buffering to it . 

open file, assign buffering to . 

open file descriptor, duplicate. 

open file for reading or writing . 

operating system, append to an existing operating system . 

operating system, change to different OS or different version of same OS 

operating system, check integrity of OS in SDF boot area(s) . 

operating system, copy from one or more SDF boot areas to another . 

operating system, create new operating system from ordinary files . 

operating system management package description . 

operating system, mark as loadable or non-loadable . 

operating system, shut down OS with optional re-boot . 

operating system, split into one or more ordinary files . 

optarg . 

opterr . 

optimization routines: CRT screen and cursor control . 

optind . 

option letter, get from argv . 

options, parse command line . 

options, set for terminal . 

options, set shell . 

opx25 . 

ordering relation, find for object library or archive file . 

ordinary file, create . 

ordinary file, create or overwrite . 

OS, append to an existing operating system . 

OS, change to different OS or different version of same OS . 

OS, check integrity of operating system in SDF boot area(s) . 

OS, copy from one or more SDF boot areas to another . 

OS, create new operating system from ordinary files. 

OS management package description. 


. nm(l) 

revision(l), uname(l), uname(2) 

. hostname (1) 

. nohup(l) 

. nl_string(3C) 

. nroff(l) 

. tbl(l) 

. col(l) 

. deroff(l) 

. printmsg(3C) 

. whereis(l) 

. adb(l) 

. nlist(3C) 

. size(l) 

. linkinfo(l) 

. nm(l) 

. strip(l) 

. ld(l) 

. lorder(l) 

. od(l) 

. od(l) 

. man(l) 

. catman(lM) 

. open (2) 

. fopen(3S) 

. setbuf(3S) 

. dup2(2) 

. open(2) 

. oscp(lM) 

.. chsys(lM)) 

. osck(lM) 

. oscp(lM) 

. oscp(lM) 

. osmgr(lM) 

.. osmark(lM) 

. stopsys(lM) 

. oscp(lM) 

. getopt(3C) 

. getopt(3C) 

. curses (3X) 

. getopt(3C) 

. getopt(3C) 

. getopt(l) 

. stty(l) 

. sh(l) 

. opx25(lM) 

. lorder(l) 

. mknod(2) 

. creat(2) 

. oscp(lM) 

. chsys(lM) 

. osck(lM) 

. oscp(lM) 

. oscp(lM) 

. osmgr(lM) 
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Permuted Index 


OS, mark as loadable or non-loadable . osmark(lM) 

OS, shut down operating system with optional re-boot . stopsys(lM) 

OS, split operating system into one or more ordinary files . oscp(lM) 

osck . osck(lM) 

oscp. oscp(lM) 

osmark. osmark(lM) 

osmgr . osmgr(lM) 

output character or word to open file or standard output . putc(3S) 

output, description of formatted/unformatted output to printer . lp(4) 

output, description of system handling of terminal output . tty(4) 

output, print formatted data into string . printf(3S) 

output, print formatted data on buffered open file . printf(3S) 

output, print formatted data on standard output . printf(3S) 

output string to open file or standard output . puts(3S) 

overlay program onto existing process and execute . sh(l), exec(2) 

overview of accounting commands . acct(lM) 

owner, change for file . chown(l), chown(2) 

page. more(l) 

page size, set for paged data . uconfig(lM) 

paged data, set for program . chatr(l) 

paging and swapping enable . swapon(lM) 

PAM . pam(l) 

parameter substitution . sh(l) 

parameters, environment . sh(l), environ(7) 

parameters, install in environment . sh(l) 

parameters, mark as readonly . sh(l) 

parameters, perform left-shift on positional . sh(l) 

parameters, set for terminal . stty(l) 

parameters, set for terminal on login . tset(l) 

parent process ID, get for process. getpid(2) 

parity, settings for terminal. fty(4) 

parse command line options . getopt(l) 

Pascal compiler . pc(l) 

passwd . passwd(l) 

password, change login . passwd(l) 

password encryption. crypt(3C) 

password file, close . getpwent(3C) 

password file, description of . passwd(5) 

password file, get line containing matching user ID . getpw(3C) 

password file, output line similar to those contained in . putpwent(3C) 

password file, read one line from . getpwent(3C) 

password file, rewind . getpwent(3C) 

password file, search for matching user ID . getpwent(3C) 

password file, search for matching user name . getpwent(3C) 

password, read from /dev/tty or standard input . getpass(3C) 

password/group file checkers . pwck(lM) 

paste . paste(l) 

path name, get for terminal . ttyname(3C) 

path name, isolate directory name from . basename(l) 

path name, isolate file name from . basename(l) 

pattern, find and process within text . awk(l) 

pattern, search contents of file for . grep(l) 

pause . pause(2) 

pause, suspend process for interval . sleep(3C) 

pc . pc(l) 
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pclose . popen(3S) 

PEEKC . regexp (7) 

periodic, automatic sync . syncer(l) 

permission bits, change for file . chmod(l), chmod(2) 

per-process accounting file format . acct(5) 

perror . perror(3C) 

personal applications manager, a command shell. pam(l) 

physical address mapping . iomap(4) 

pipe . pipe(2) 

pipe, create/close between process and command . popen(3S) 

pipe, get intermediate data from . tee(l) 

pipeline, create . pipe(2) 

pipeline, get intermediate data from . tee(l) 

place error messages from C source into a file . mkstr(l) 

plock . plock(2) 

plotter, description of hpib interface to . hpib(4) 

popen . popen(3S) 

port, database listing terminal type connected to each . ttytype(5) 

portable code between HP-UX implementations, typedefs for . model(5) 

position magnetic tape . mt(l) 

positional parameters, perform left-shift on . sh(l) 

posters, make using large letters. banner(1) 

pow . exp(3M) 

power function . exp(3M) 

powerfail . brc(lM) 

Pi*. pi’ll) 

prealloc . prealloc (1) 

preallocate disc storage . prealloc (1) 

preprocessor for C compiler . cpp(l) 

print and format files . pi’ll) 

print and summarize an SCCS file . prsll) 

print arguments after shell interpretation . echoll) 

print, copy, and/or concatenate files . catll) 

print current SCCS file editing activity . sactll) 

print documents formatted with mm macros . mmll) 

print effective current user id . whoamill) 

print formatted data on standard output, open file, or string . printfl3S) 

print formatted output from varargs argument list . vprintfl3S) 

print formatted output with numbered arguments . printmsgl3C) 

print last part of file . tailll) 

print list of users and their current processes . whodollM) 

print name list Isymbol table) of object file . nmll) 

print name of current working directory. pwdll) 

print news items . newsll) 

print time and date . datell) 

print user, group IDs and names . idll) 

printer, description of formatted/unformatted output . Ipl4) 

printer, description of hpib interface to . hpibl4) 

printer options, set . slpll) 

printf. printfl3S) 

printmsg . printmsgl3C) 

priority, run command at lower or higher . nicell), nicel2) 

privileged values format . privgrplfi) 

procedures: shell procedures for accounting. acctshllM) 

process accounting . acctprcllM) 
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Permuted Index 


process accounting commands . 

process and system state initialization. 

process, change data segment space allocation for . 

process, change root directory of . 

process, create a new . 

process, create/close pipe between process and command. 

process, enable break-point debugging of child process. 

process, format of core image of terminated process . 

process, get ID, group ID, and parent process ID of. 

process, get real/effective user and real/eflfective group ID’s for 

process, get/set file size limit for. 

process group ID, set . 

process, lock/unlock address space or segment . 

process number, get. 

process, overlay new program onto existing . 

process, print accumulated user and system time elapsed for .... 

process, send SIGIOT to . 

process, send signal to . 

process, set group ID for . 

process status, report . 

process, suspend execution for interval of time . 

process, suspend until signal. 

process, terminate.. 

process, time execution of . 

process, wait for completion of. 

processes, list active. 

processes, send signal to all user processes . 

processes, specify maximum number of processes per user . 

processes, terminate all user processes . 

processor type . 

prof. 

profil . 

profile, create for program during execution . 

profile data, display . 

profile files, description of /etc/profile and $HOME/.profile . 

program, add diagnostics to . 

program, change internal attributes of. 

program, check/verify C . 

program, create execution profile for . 

program, create from object files . 

program, debugger for . 

program, execute command from. 

program, force action associated with signal to be taken. 

program, format C . 

program, generate for lexical analysis of text . 

program, get particular addresses associated with . 

program, get size of . 

program, locate source, binary, and/or on-line manual page for 

program, maintain, update, and recompile. 

program, overlay onto existing process and execute . 

program, run immune to hangups, logouts, and quits . 

program, set up signal handling for . 

program verification . 

provide semaphores and record locking on files. 

provide truth value about your processor type . 


. acctcom(l) 

... init(lM) 

. brk(2) 

. chroot(l), chroot(2) 

. fork(2) 

. popen(3S) 

. ptrace(2) 

. core(5) 

. getpid(2) 

. getuid(2) 

. ulimit(2) 

. setpgrp(2) 

. memlck(2) 

. getpid(2) 

. sh(l), exec(2) 

. sh(l) 

. abort(3C) 

. kill(l), kill(2), abort(3C) 

. setpgrp(2) 

. ps(l) 

. sleep(l), sleep(3C) 

. pause(2) 

kill(l), sh(l), exit(2), kill(2), abort(3C) 

. times(2) 

. sh(l), wait(l), wait(2) 

. ps(l) 

. killall(lM) 

. uconfig(lM) 

. shutdown(IM) 

. machid(l) 

. prof(l) 

.. profil(2) 

. profil(2), monitor(3C) 

. prof(l) 

. profile(5) 

. assert (3X) 

. chatr(l) 

. lint(l) 

. profil(2), monitor(3C) 

. ld(l) 

. adb(l) 

. system(3S) 

. ssignal(3C) 

. cb(l) 

. lex(l) 

. end(3C) 

. size(l) 

. whereis(l) 

. make(l) 

. sh(l), exec(2) 

. nohup(l) 

. signal(2), ssignal(3C) 

. assert (3X) 

. lockf(2) 

. machid(l) 
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Permuted Index 


prs . prs(l) 

PS. ps(l) 

pseudo-random number generator. drand48(3C) 

pseudo-random numbers . drand48(3C) 

pseudo-terminal driver . pty(4) 

ptrace . ptrace(2) 

pty . pty(4) 

public UNIX-to-UNIX file copy . uuto(l) 

push character back into input stream . ungetc(3S) 

putc. putc(3S) 

putchar . putc(3S) 

putenv . putenv(3C) 

putpwent . putpwent(3C) 

puts . puts(3S) 

putw. putc(3S) 

pwck . pwck(lM) 

pwd . pwd(l) 

pwd.h . passwd(5) 

Pythagorean theorem function . hypot(3M) 

qsort . qsort(3C) 

query . query (1) 

quit character, description of. tty(4) 

quits, run command immune to . nohup(l) 

quoting, as used by the shell. sh(l) 

rand . rand(3C) 

random number generator . drand48(3C) 

random number generator . rand(3C) 

randomized library/archive, table of contents format description . ranlib(5) 

ranlib.h, description of . ranlib(5) 

raw interface to disc, description of. disc(4) 

raw mode, description of raw mode interface to magnetic tape . mt(4) 

raw mode, description of raw output to printer . lp(4) 

rc . brc(lM) 

read . sh(l), read(2) 

read and format data from buffered open file . scanf(3S) 

read and format data from standard input. scanf(3S) 

read and format data from string . scanf(3S) 

read character from buffered open file . getc(3S) 

read error indicator on open file . terror(3S) 

read from a file using buffers . fread(3S) 

read from file . read(2) 

read from standard input . sh(l) 

read operation, reposition next . fseek(3S) 

read password from /dev/tty or standard input . getpass(3C) 

read text in convenient chunks on soft-copy terminal . more(l) 

read word from buffered open file . getc(3S) 

read-ahead, set number of buffers allocated to. uconfig(lM) 

readonly. sh(l) 

read/write file pointer, move (seek) . lseek(2) 

real group ID, get for process . getuid(2) 

real user ID, get for process. getuid(2) 

realloc. malloc(3C) 

real-time priority, change or read . rtprio(2) 

real-time priority, execute process with . rtprio(l) 

reblock tape file. dd(l) 
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Permuted Index 


reboot . 

reboot. 

re-boot operating system after shut-down . 

reboot system. 

reboot the system. 

record locking and semaphores on files . 

record login names, login times, and tty names for user 

regexp.h, description of. 

regular expression compile and match routines . 

relational database operator . 

release blocked signals and wait for interrupt . 

release Command Set 80 cartridge tape. 

release number, get current . 

relocation bits, remove from object file . 

remind you when you have to leave . 

remind you when you have to leave . 

reminder service . 

remote system, execute work requests on . 

remove a directory file . 

remove a LIF file . 

remove backing store devices . 

remove BIF files or directories . 

remove delta from SCCS file . 

remove duplicate lines in file . 

remove extra new-line characters from file. 

remove files or directories . 

remove link to file. 

remove message queue . 

remove multiple line-feeds from output . 

remove nroff/troff, tbl, and eqn constructs. 

remove selected fields from each line of a file . 

remove selected table column entries from file . 

remove semaphore set . 

remove shared memory id . 

remove symbol table and relocation bits from object file 

rename LIF files . 

repair file system inconsistencies . 

report inter-process communication facilities status . 

report number of free disc blocks . 

report CPU time used . 

reserve a terminal .. 

reset error indicator on open file. 

RETURN . 

revck . 

reverse line-feeds and backspaces, interpret for nroff(l) . 

reverse previous of SCCS file. 

revision . 

revision information, get HP-UX. 

revision numbers, check for HP-UX files . 

rewind . 

rewind a file . 

rewind group file . 

rewind magnetic tape .. 

rewind password file . 

rm. 


. reboot(lM) 

. reboot (2) 

. stopsys(lM) 

. reboot(IM) 

. reboot (2) 

. lockf(2) 

. utmp(5) 

. regexp (7) 

. regexp (7) 

. join(l) 

. sigpause(2) 

. tcio(l) 

revision(l), uname(l), uname(2) 

. strip(l) 

. leave (1) 

. leave(l) 

. calendar(l) 

. uucico(lM), uux(l) 

. rmdir(2.) 

. lifrni(l) 

. vson(2) 

. bifrm(l) 

. rmdel(l) 

. uniq(l) 

. rmnl(l) 

. rm(l) 

. link(lM), unlink(2) 

. ipcrm(l) 

. ssp(l) 

. deroff(l) 

. cut(l) 

. cut(l) 

. ipcrm(l) 

. ipcrm(l) 

. strip(l) 

. lifrename(l) 

. fsck(lM), fsdb(lM) 

. ipcs(l) 

. bifdf(l) 

. clock(3C) 

. lock(l) 

. ferror(3S) 

. regexp (7) 

. revck(lM) 

. col(l) 

. unget(l) 

. revision(l) 

. revision(l) 

. revck(lM) 

. fseek(3S) 

. fseek(3S) 

. getgrent(3C) 

. mt(l) 

. getpwent(3C) 

. rm(l) 
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Permuted Index 


rmail. mail(l) 

rmdel. rmdel(l) 

rmdir . rm(l) 

rmdir . rmdir(2) 

rmnl . rmnl(l) 

romanS . roman8(7) 

root directory, change for duration of command. chroot(l), chroot(2) 

root volume, mark/unmark volume as HP-UX root volume . rootmark(lM) 

rootrnark . rootmark(lM) 

rtprio . rtprio(l) 

run a command at low priority . nice(l), nice(2) 

run a command immune to hangups, logouts, and quits . nohup(l) 

run daily accounting . runacct(lM) 

runacct . runacct(lM) 

CPU time report . clock(3C) 

CS/80 cartridge tape special file. ct(4) 

GPIO routines (device I/O library) . gpio_*(3I) 

HALGOL programs . opx25(lM) 

HP-IB routines (device I/O library) . hpib_*(3I) 

IMAGE database access . query(l) 

I/O routines (device I/O library) . io_*(3I) 

KERMIT-protocol file transfer program. kermit(lM) 

LP spooler system, configure . mklp(lM) 

MPE/RTE-style message catalog support . catread(3C) 

MPE/RTE-style message catalog support . catread(3C) 

UUCP system snapshot . uusnap(l) 

XMODEM protocol file transfer program. umodem(lM) 

XMODEM protocol file transfer program. umodem(lM) 

sact . sact(l) 

sbrk . brk(2) 

scan text for pattern and process . awk(l) 

scanf. scanf(3S) 

sees, ask for help concerning. help(l) 

sees file, change delta commentary of . cdc(l) 

sees file, check for validity . val(l) 

sees file, compare two versions of. sccsdiff(l) 

sees file, create delta (change) for. delta(l) 

sees file, description of SeeS file format . sccsfile(5) 

sees file, get identification information from . what(l) 

sees file, get version of. get(l) 

sees file, print and summarize . prs(l) 

sees file, print current editing activity for . sact(l) 

sees file, print delta summary of. get(l) 

sees file, remove delta from . rmdel(l) 

sees file, reverse previous get(l) of . unget(l) 

sees files, create or change parameters of . admin(l) 

scesdiff . sccsdiff(l) 

schedule commands at specified date(s) and time(s) . at(l), cron(lM) 

screen handling and optimization routines . curses(3X) 

SDF boot area, copy OS from one or more SDF boot areas to another . oscp(lM) 

SDF, description of. dir(5) 

SDF, description of SDF volume . fs(5) 

SDF volume, format, initialize, and certify . sdfinit(lM) 

sdfinit . sdfinit(lM) 

search an ASCII file for pattern . grep(l) 
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Permuted Index 


search tables, hash-coded . 

security control, dialup . 

sed . 

seek to new position in file. 

segment length, modify . 

segment, lock/unlock for process . 

segment reference patterns, inform operating system about 

select . 

select/reject common lines of two files . 

semaphore control operations . 

semaphore operations . 

semaphores and record locking on files . 

semaphores, get . 

semctl. 

semget . 

semop . 

send mail to users or read mail . 

send signal to all user processes. 

set. 

set current signal mask . 

set group access list .. 

set name of host cpu . 

set options for terminal port . 

set or change real-time priority . 

set or print name of current host system . 

set printer options . 

set process’s alarm clock . 

set special attributes for group. 

set system parameters . 

set tabs on a terminal . 

set the modes of a terminal. 

set time and date . 

set user and group IDs . 

setbuf. 

setgid . 

setgrent . 

set-group-ID bit, set/clear for file . 

setgroups . 

sethostname . 

setitimer . 

setjmp . 

setkey . 

setmnt . 

setpgrp . 

setprivgrp. 

setprivgrp . 

setpwent . 

settimeofday . 

setuid. 

set-user-ID bit, set/clear for file . 

sh. 

shareable, mark or unmark program code as . 

shared memory control operations .. 

shared memory operations .. 

shared memory segment, get . 


. hsearch(3C) 

. dialups(5) 

. sed(l) 

. lseek(2) 

. memvary(2) 

. memlck(2) 

. memadvise(2) 

. select (2) 

. comm(l) 

. semctl(2) 

. semop(2) 

. lockf(2) 

. semget(2) 

. semctl(2) 

. semget (2) 

. semop(2) 

. mail(l) 

. killall(lM) 

. Sh(l) 

. sigsetmask(2) 

. setgroups (2) 

. sethostname(2) 

. stty(l) 

. rtprio(l) 

. hostname (1) 

. slp(l) 

. alarm(2) 

. setprivgrp(lM) 

. uconfig(lM) 

. tabs(l) 

. getty(lM) 

. date(l), stime(2) 

. setuid(2) 

. setbuf(3S) 

. setuid(2) 

. getgrent(3C) 

. chmod(l), chmod(2) 

. set groups (2) 

. sethostname (2) 

. setitimer(2) 

. setjmp(3C) 

. crypt(3C) 

. setmnt (IM) 

. setpgrp(2) 

. setprivgrp(IM) 

setprivgrp(IM), setprivgrp(2) 

. getpwent(3C) 

. settimeofday(2) 

. setuid(2) 

. chmod(l), chmod(2) 

. sh(l) 

. chatr(l) 

. shmctl(2) 

. shmop(2) 

. shmget(2) 
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Permuted Index 


shell . sh(l) 

shell, change default login . chsh(l) 

shell command, issue from program . system(3S) 

shell, command. Personal Applications Manager . pam(l) 

shell, input commands to . sh(l) 

shell procedures for accounting . acctsh(lM) 

shell programming language . sh(l) 

shell scripts, system initialization. brc(lM) 

shell, set/clear flags to . sh(l) 

shift . sh(l) 

shmctl . shmctl(2) 

shmget . shmget(2) 

shmop . shmop(2) 

show group memberships . groups(l) 

shut down operating system with optional re-boot . stopsys(lM) 

shutdown . shutdown(IM) 

shutdown status of specifled file system . fsclean(lM) 

sigblock . sigblock(2) 

sign on . login(l) 

signal. signal (2) 

signal facilities, software . sigvector(2) 

signal, force action associated with signal to be taken. ssignal(3C) 

signal handling for program, set up . signal(2), ssignal(3C) 

signal mask, set . sigsetmask(2) 

signal, send SIGIOT to process . abort(3C) 

signal, send to all user processes. killall(lM) 

signal, send to process . kill(l), kill(2), abort(3C) 

signal, set trap for . sh(l) 

signal stack space . sigspace(2) 

signal, suspend process until receipt of. pause(2) 

signgam . gamma(3M) 

signs, make using large letters . banner(1) 

sigpause. sigpause(2) 

sigsetmask . sigsetmask(2) 

sigspace . sigspace(2) 

sigvector . sigvector(2) 

simple text formatter. adjust (1) 

sin . trig(3M) 

sine function . trig(3M) 

sine, hyperbolic . sinh(3M) 

sinh . sinh(3M) 

size . size(l) 

size of an object file . size(l) 

sleep . sleep(l) 

sleep. sleep (3C) 

sip. slp(l) 

snapshot of the UUCP system . uusnap(l) 

software signal facilities . sigvector(2) 

sort . sort(l) 

sort algorithm . qsort(3C) 

sort and/or merge files . sort(l) 

sort, topological . tsort(l) 

source code, locate for program . whereis(l) 

spaces, convert to tabs, and vice versa . expand(l) 

special characters in terminal interface, description of . tfy(4) 
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Permuted Index 


special file, create block/character/network . 

special file, create fifo . 

special file, identify for file name on mounted file system . 

special file, modem control . 

special file, CS/80 cartridge tape. 

special file, system "bit bucket" . 

special files, perform functions on . 

special files, utilities used in creating special files . 

spell . 

spellin. 

spelling errors, find. 

spellout . 

split . 

split a file into pieces. 

split operating system into one or more ordinary files. 

spool directory clean-up for uucp . 

sprintf . 

sputl . 

sqrt. 

square root function . 

srand . 

sscanf . 

ssignal . 

ssp . 

stack size, specify size in bytes. 

standard input, copy one line from to standard output . 

standard input, read from. 

standard inter-process communication package .. 

start character, resume output, description of. 

stat . 

stat(2)/fstat(2), description of structure returned by these calls 

state, defining system states for init(lM) .. 

state, initialization of system state and processes . 

stat.h, description of . 

status flags, get/set for file . 

status, get for file . 

status, inter-process communication facilities. 

stdio . 

stdipc . 

step . 

sticky bit, set/clear for file . 

stime. 

stop character, suspend output, description of . 

stop operating system with optional re-boot . 

stopsys. 

strcat . 

strchr. 

strcmp . 

strcpy . 

strcspn . 

stream, close or flush . 

stream text editor . 

string collation, non-ASCII, used by NLS . 

string, copy. 

string, get length of . 


mkdev(lM), mknod(2), mknod(lM) 

.. mknod(2), mknod(lM) 

. devnm(lM) 

. modem(4) 

. ct(4) 

. null (4) 

. ioctl(2), stty(2) 

. mknod(5) 

. spell (1) 

. spell(l) 

. spell(l) 

. spell(l) 

. split (1) 

. split (1) 

. oscp(lM) 

. uuclean(lM) 

. printf(3S) 

. sputl (3X) 

. exp(3M) 

. exp(3M) 

.. rand(3C) 

. scanf(3S) 

. ssignal(3C) 

. ssp(l) 

.. uconfig(lM) 

. line(l) 

. sh(l) 

. stdipc(3C) 

. tty(4) 

. stat(2) 

. stat(7) 

. inittab(5) 

. init(lM) 

. stat(7) 

. fcntl(2) 

. stat(2) 

. ipcs(l) 

. stdio(3S) 

. stdipc(3C) 

. regexp (7) 

. chmod(l), chmod(2) 

. stime(2) 

. tty(4) 

. stopsys(IM) 

. stopsys(lM) 

. string(3C) 

. string(3C) 

. string(3C) 

. string(3C) 

. string(3C) 

. fclose(3S) 

. sed(l) 

. nl__5tring(3C) 

. string(3C) 

. string(3C) 
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Permuted Index 


string, print formatted data into . printf(3S) 

string, read and format data from . scanf(3S) 

string, read from buffered open file . gets(3S) 

string, search contents of file for specified . grep(l) 

string, search for particular character in . string(3C) 

string to double-precision integer conversion. strtod(3C) 

string, write to open file or standard output . puts(3S) 

strings, compare two . string(3C) 

strings, concatenate two . string(3C) 

string-to-integer conversion . strtol(3C) 

strip . strip(l) 

strip multiple line-feeds from output . ssp(l) 

strlen . string(3C) 

strncat . string(3C) 

strncmp . string(3C) 

strncpy . string(3C) 

strpbrk . string(3C) 

strrchr . string(3C) 

strspn . string(3C) 

strtod . strtod(3C) 

strtok. string(3C) 

strtol . strtol(3C) 

structure, definition of structure returned by stat(2) and fstat(2) . stat(7) 

Structured Directory Format, description of. dir(5) 

Structured Directory Format, description of SDF volume . fs(5) 

Structured Directory Format volume, format, initialize, and certify . sdfinit(lM) 

stty . stty(l) 

stty . stty(2) 

sttyvG . sttyv6(4) 

su. su(l) 

summarize and print SCCS file . prs(l) 

superblock, description of superblock in SDF volume . fs(5) 

suspend process execution for interval of time . sleep(l), sleep(3C) 

suspend process until signal. pause(2) 

swab . swab(3C) 

swap bytes . swab(3C) 

swap device, add. swapon(2) 

swap time, set for virtual segment . uconfig(lM) 

swapon . swapon(lM) 

swapon . swapon(2) 

swapping and paging enable . swapon(lM) 

symbol table, extract entries from executable file’s symbol table (name list) . nlist(3C) 

symbol table, print from object file . nm(l) 

symbol table, remove from object file . strip(l) 

symbols, examine execution profile for . prof(l) 

sync . sync(2), sync(l), syncer(l) 

syncer . syncer(lM) 

sync, automatic periodic . syncer(IM) 

synchronous I/O multiplexing . select(2) 

sys_errlist . perror(3C) 

sys__nerr . perror(3C) 

system . system(3S) 

system activity, terminate all current activity . shutdown(IM) 

system calls, error indicator for. errno(2) 

system configuration . config(lM) 
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Permuted Index 


system error logging file . 

System III compatibility for magnetic tape, description of . 

system initialization shell scripts . 

system name, get . 

system names, list of those known to uucp . 

system parameters, set or list . 

system reboot. 

system reconfiguration . 

system state, defining states for init(lM) . 

system state, initialization of. 

table of contents format description for archives/libraries . 

table of devices mounted by mount(IM) . 

table of mounted devices, create . 

table search, binary . 

tables, format for nroff/troff . 

tabs . 

tabs, expand to spaces, and vice versa . 

tabs, put tab specifications in text files . 

tabs, set on terminal . 

tail . 

tan . 

tangent function . 

tangent, hyperbolic . 

tanh. 

tape, archive files on . 

tape. Command Set 80 cartridge utility . 

tape density, how to set for magnetic tape . 

tape, description of magnetic tape raw interface and controls . 

tape file archiver. 

tape file, convert, reblock, translate and/or copy . 

tape initialization .. 

tape, manipulate and/or position. 

tape, unpack/extract files from Command Set 80 cartridge . 

tar . 

tbl . 

tbl, nroff, troff, eqn constructs, remove from text . 

tcio . 

tee . 

temporary file, create and open . 

temporary file, generate name for . 

termcap. 

termcap description to terminfo description, convert . 

terminal capabilities, database for vi editor . 

terminal capabilities in terminfo(5), access . 

terminal commands, description of ioctl(2) system call commands .... 

terminal, database listing terminal type for each port . 

terminal dependent initialization . 

terminal, description of general interface to . 

terminal driver, pseudo- . 

terminal emulation, asynchronous . 

terminal, establish communication with terminal for login . 

terminal, facilitate viewing of continuous text on . 

terminal, find baud rate of terminal during login process . 

terminal flags, mapping between pwb/V6 UNIX and current HP-UX 
terminal, generate file name for . 


. errfile(5) 

. mt(4) 

. brc(lM) 

revision(l), uname(l), uname(2) 

. uucp(l) 

. uconfig(lM) 

. reboot (IM) 

. uconfig(lM) 

. inittab(5) 

. init(lM) 

. ranlib(5) 

. mnttab(5) 

. setmnt(lM) 

. bsearch(3C) 

. tbl(l) 

. tabs(l) 

. expand(l) 

. fspec(5) 

. tabs(l) 

. tail(l) 

. trig(3M) 

. trig(3M) 

. sinh(3M) 

. sinh(3M) 

. tar(l) 

. tcio(l) 

. mt(4) 

. mt(4) 

. tar(l) 

. dd(l) 

. mediainit(l) 

. mt(l) 

. upm(l) 

. tar(l) 

. tbl(l) 

. deroff(l) 

. tcio(l) 

. tee(l) 

. tmpfile(3S) 

. tmpnam(3S) 

. termcap(3C), terminfo(5) 

. captoinfo(lM) 

. terminfo(5) 

. termcap(3C) 

. tty(4) 

. ttytype(5) 

. tset(l) 

. tty(4) 

. pty(4) 

. aterm(l) 

. getty(lM) 

. more(l) 

. getty(lM) 

. tty(4) 

. ctermid(3S) 
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Permuted Index 


terminal, get path name of . 

terminal, get path name of user’s . 

terminal input control, description of . 

terminal interface, general . 

terminal interface, version 6/PWD-compatibility. 

terminal, permit/deny messages to . 

terminal screen, clear . 

terminal screen handling and optimization routines . 

terminal, set options for . 

terminal, set tabs on. 

terminal, set type and mode on login . 

terminal, test file descriptor for association with . 

terminals, list of recognized terminal names . 

terminals, list of supported terminals in terminfo(5) . 

terminate a process . 

terminate all users’ processes . 

terminfo compiler. 

terminfo database access . 

terminfo description from termcap description, convert . 

termio . 

test . 

test conditional expressions . 

text editor . 

text editor, database of terminal capabilities for vi . 

text editor, stream . 

text editor (variant of ex for casual users) . 

text editor, visual . 

text, facilitate CRT viewing of continuous . 

text file, put format specifications in . 

text, find spelling errors in . 

text format specifications, put in text file . 

text formatter . 

text formatter, simple. 

text formatting, description of man macros . 

text formatting, description of mm macros . 

text formatting, remove nroff/troff/tbl/eqn constructs from text 

text, generate programs for lexical analysis of . 

text pattern scanning and processing language . 

text, print using mm macros . 

tgetent . 

tgetflag . 

tgetnum . 

tgetstr . 

tgoto . 

three-way differential file comparison . 

tic . 

time. 

time. 

time a command . 

time and date, convert to ASCII string. 

time and date, get more precisely . 

time, corrected for daylight saving time and time zone . 

time execution of a process and its child processes . 

time, get seconds since 00:00:00 GMT, January 1, 1970 . 

time, get/set . 


. ttyname(3C) 

. tty{l) 

. tty{4) 

. termio(4) 

. sttyv6(4) 

. mesg(l) 

.. clear(l) 

. curses (3X) 

. stty(l) 

. tabs(l) 

. tset(l) 

. ttyname(3C) 

. term(7) 

. term(7) 

kill(l), sh(l), exit(2), kill(2), abort(3C) 

. shutdown(IM) 

. tic(lM) 

. tput(l) 

. captoinfo(lM) 

. termio (4) 

. sh(l), test(l) 

. sh(l), test(l) 

. ed(l), ex(l) 

. terminfo(5) 

. sed(l) 

. edit(l) 

. Vi(l) 

. more(l) 

. fspec(5) 

. spell(l) 

. fspec(5) 

. nroff(l) 

. adjust(1) 

. man(7) 

. mm(7) 

. deroff(l) 

. lex(l) 

. awk(l) 

. mm(l) 

. termcap (3C) 

. termcap (3C) 

. termcap (3C) 

. termcap(3C) 

. termcap(3C) 

. diff3(l) 

. tic(lM) 

. time(l) 

. time(2) 

. time(l) 

. ctime(3C) 

. ftime(2) 

. ctime(3C) 

. times(2) 

. time(2) 

. gettimeofday(2) 
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Permuted Index 


time, print elapsed user and system time for process . 

time, set and/or print . 

time to leave . 

time zone, time corrected for. 

time/date stamps, correct those on wtmp records . 

times. 

timezone. 

tmpfile. 

tmpnam . 

toascii. 

—tolower . 

tolower . 

topological sort . 

touch . 

—toupper . 

toupper . 

tput . 

tputs . 

tr . 

transfer files between two systems . 

translate assembly language . 

translate characters during copy from standard input to standard output 

translate characters for NLS. 

translate tape file . 

trap .. 

trap numbers for hardware . 

trap, set for particular signal . 

trapno . 

trapno, report value for last command failure . 

trigonometric functions . 

troff, format tables for . 

troff, nroff, tbl, eqn constructs, remove from text . 

true. 

truth value about your processor type . 

truth values . 

tset . 

tsort. 

tty . 

tty name, record for each user (accounting) . 

tty port, database listing terminal type connected to each . 

ttyname . 

ttyslot . 

tune a file system . 

type declarations, data type definitions for system code . 

typedefs for code portability between HP-UX implementations . 

types.h, description of. 

tzname . 

tzset . 

uconfig . 

ul . 

ulimit . 

umask. 

umodem . 

umount . 

uname . 


. sh(l) 

. date(l), stime(2) 

. leave (1) 

. ctime(3C) 

. fwtmp(lM) 

. sh(l), times(2) 

. ctime(3C) 

. tmpfile(3S) 

. tmpnam(3S) 

.. conv(3C) 

. conv(3C) 

. conv(3C) 

. tsort(1) 

. touch(l) 

. conv(3C) 

. conv(3C) 

. tput(l) 

. termcap(3C) 

. tr(l) 

. uucp(l), uuto(l) 

. atrans(l) 

. tr(l) 

. nl_conv(3C) 

. dd(l) 

. 

. trapno(2) 

sh(l), signal(2), ssignal(3C) 

. trapno (2) 

. err(l) 

. trig(3M) 

. tbl(l) 

. deroff(l) 

. true(l) 

. machid(l) 

. true(l) 

. tset(l) 

. tsort(1) 

. tty(l) 

. utmp(5) 

. ttytype(5) 

. ttyname (3C) 

. ttyslot (3C) 

. tunefs(lM) 

. types(7) 

. model(5) 

. types(7) 

. ctime(3C) 

. ctime(3C) 

. uconfig(lM) 

. ul(l) 

. ulimit (2) 

sh(l), umask(l), umask(2) 

. umodem (IM) 

. mount(IM), umount(2) 

. uname(l), uname(2) 
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unblocked disc interface, description of . 

uncompact .. 

uncompiler: terminfo . 

underlining, translate underscores to terminal escape sequence. 

underscores, translate to terminal escape sequence for underlining 

unexpand . 

unget . 

UNGETC . 

ungetc . 

uniformly-distributed pseudo-random number generator . 

uniq. 

unique lines, find after comparing two files . 

UNIX/HP-UX system, establish communication with another . 

unlink . 

unlock/lock process address space or segment . 

unmount or mount file system . 

unpack cpio archives from HP media . 

unprintable characters in a file visible or invisible . 

untie . 

update access/modification/change times of file. 

update, maintain, recompile programs . 

update super-block . 

upm . 

upper-case to lower-case character conversion . 

use findstring output to insert calls to getmsg . 

user crontab file . 

user environment, description of. 

user ID, get line from password file with matching . 

user ID, print . 

user ID, search password file for matching . 

user ID, set . 

user name, print . 

user name, search password file for matching. 

user processes, terminate all . 

user, switch to another . 

users, print list of current . 

users, print list of users and their current processes . 

ustat . 

utilities. Bell Interchange Format file operations . 

utime . 

utmp accounting file, description of . 

utmp file current user slot . 

utmp.h, description of. 

uucico . 

unclean . 

UUCP . 

UUCP command execution.. 

UUCP network, monitor activity . 

UUCP spool directory clean-up . 

UUCP system names, list of. 

UUCP transactions grouped by transaction, list . 

uucp/uux transactions, log of .. 

uulog . 

uuls . 

uuname. 


. disc (4) 

. compact (1) 

. untie (IM) 

. Ul(l) 

. Ul(l) 

. expand(l) 

. unget (1) 

. regexp (7) 

. ungetc (3S) 

. drand48(3C) 

. uniq(l) 

. comm(l) 

. cu(l) 

. link(lM), unlink(2) 

. memlck(2) 

mount(lM), mount(2), umount(2) 

. upm(l) 

.. vis(l) 

.. untie (IM) 

. touch(l), utime(2) 

. make(l) 

. sync(2), sync(l) 

. upm(l) 

. conv(3C) 

. insertmsg(l) 

. crontab(l) 

. environ(7) 

. getpw(3C) 

. 

. getpwent(3C) 

. setuid(2) 

. id(l) 

. getpwent(3C) 

. shutdown(lM) 

. su(l) 

. who(l) 

. whodo(lM) 

. ustat (2) 

. bif(5) 

. utime(2) 

. utmp(5) 

. ttyslot(3C) 

. utmp(5) 

. uucico (IM) 

. uuclean(lM) 

. uucp(l) 

. uuxqt(lM) 

. uusub(lM) 

. uuclean(lM) 

. uucp(l) 

. uuls(l) 

. uucp(l) 

. uucp(l) 

. uuls(l) 

. uucp(l) 
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uupick . uuto(l) 

uusnap . uusnap(l) 

uusub . uusub(lM) 

uuto . uuto(l) 

uux. uux(l) 

uiixqt . uuxqt (IM) 

val . val(l) 

validate password and group files . pwck(lM) 

validate SCCS file . val(l) 

values . values(7) 

values, machine-dependent . values(7) 

varargs . varargs(7) 

varargs argument list, print formatted output from . vprintf(3S) 

variable argument list handling facility . varargs (7) 

verify C program . lint(l) 

verify Command Set 80 cartridge tape . tcio(l) 

verify file system consistency . fsck(lM) 

verify password and group files . pwck(lM) 

version 6/PWD-compatibility terminal interface. sttyv6(4) 

version name, get for HP-UX . uname(l), uname(2) 

version number, get . revision(l) 

versions, compare two SCCS file versions . sccsdiff(l) 

vfork . fork(2) 

vi. vi(l) 

vi editor, database of terminal capabilities for . terminfo(5) 

view . vi(l) 

viewing text, facilitate on soft-copy terminals . more(l) 

virtual memory page pool, specify maximum size of . uconfig(lM) 

virtual memory usage, set or clear for program . chatr(l) 

virtual memory working set ratio, set . uconfig(lM) 

virtual segment, establish time segment remains memory resident . uconfig(lM) 

vis . vis(l) 

visual text editor . vi(l) 

volume, description of SDF volume superblock . fs(5) 

volume, format, initialize, and certify SDF volume . sdfinit(lM) 

volume header, write LIF on file . lifinit(l) 

volume, mark/unmark as HP-UX root volume . rootmark(lM) 

vprintf . vprintf(3S) 

vsadv . vsadv(2) 

vsoff . vson(2) 

vson . vson(2) 

wait . sh(l), wait(l), wait(2) 

wait for completion of process . sh(l), wait(l), wait(2) 

walk a file tree . ftw(3C) 

wall . wall(lM) 

wc . wc(l) 

wc . wc(l) 

what . what(l) 

whereis . whereis(l) 

while loop, exit from enclosing . sh(l) 

while loop, resume the next iteration of. sh(l) 

who. who(l) 

whoami . whoami(l) 

whodo . whodo(lM) 

word count . wc(l) 
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word, read from buffered open file . getc(3S) 

word, write on buffered open file or standard output . putc(3S) 

words, count number contained in file . wc(l) 

working directory, change . cd(l), sh(l), chdir(2) 

working directory, print name of . pwd(l) 

write . write(l), write(2) 

write character on buffered open file or standard output . putc(3S) 

write current contents of memory to disc . sync(2), sync(l) 

write interactively to another user . write(l) 

write LIF volume header on file . lifinit(l) 

write on a file . write(2) 

write operation, reposition next . fseek(3S) 

write password file entry . putpwent(3C) 

write string to open file or standard output . puts(3S) 

write to a file using buffers . fread(3S) 

write to all users . wall(lM) 

write word on buffered open file or standard output . putc(3S) 

wtmp accounting file, description of . utmp(5) 

wtmp records, convert from binary to ASCII . fwtmp(lM) 

wtmp records, correct time/date stamps on. fwtmp(lM) 

wtmpfix . fwtmp(lM) 

X.25 line, get . getx25(lM) 

xd . od(l) 

yO . bessel(3M) 

yl . bessel(3M) 

yacc . yacc(l) 

yn . bessel(3M) 
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